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THE BASIC USE OF THE VISITREND™/VISIPLOT™ 
PROGRAM 


If you have not read the Introduction, do so before continuing; it con¬ 
tains the basic information that this lesson assumes you already know. It 
tells you how to load the VisiTrend/VisiPlot program, what the cursor is, 
how to move the cursor, and more. 

This lesson assumes you know: 

• How to load the VisiTrend/VisiPlot program from diskette. 

• How to move the cursor in a menu and in a list. 

• How to select an item from a menu and a list. 

If you are not sure how to perform any of these functions, reread the 
sections of the Introduction that describe them. 




This lesson introduces some of the major functions you encounter using 
the VisiTrend/VisiPlot program. This lesson deals almost totally with the 
Plot program. You are given instructions on how to load some plotting 
data and how to get to the Plot program. There are no explanations of 
these directions in this lesson; they are explained in Lesson Two. 
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LOADING THI PROGRAM 

Load the VisiTrsnd/VisiPlot program according to the directions in the 
section "Loading the VisiTrend/VisiPlot Program!' For the purpose of 
this lesson, do not put a diskette in Drive 2 if you have a multiple drive 
system. Leave the Lnve 2 door open. 

When the program is loaded the display should look like the following 
photograph. If it does not look like this, go back to the Introduction and 
start over. 



If the bottom line of the status area reads DRIVE: 2 instead of DRIVE: 1, 
load the program again without a diskette in Drive 2. 

The Storage Management program is now loaded; this program is the 
subject of Lesson Two. For now we want to load some data that can be 
plotted, load the Plot program, and draw some charts on the screen. Press 
the following keys in the order listed: 

(make sure the cursor is on the word LOAD) 

RETURN (wait for the disk drive to stop running and make sure the 
cursor is on SAMPLE 1) 

RETURN (again wait for the drive to stop, a list of the data series in 
SAMPLE 1 is displayed) 

RETURN (the list disappears and the menu returns) 

Right Arrow (move the cursor to >PLOT) 

RETURN 
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At this point, the message YPE Y TO CONFIRM Llould be displayed 
in the status area. If this message is not displayed, move the cursor to the 
word LOAD and repeat the preceding sequence. If thei% is no menu, press 
any key except RESET. 

If you have the correct message, press the Y key on *tfre keyboard. The 
VisiTrend/VisiPlot program gives you this chance to verify that you want 
to change programs. Pressing any other key cancels the loading of the 
Plot program. 

If you accidentally pressed the wrong key, move the cursor to the word 
- >PLOT and press the RETURN key again. 

After you press the Y key, the disk drive runs for a short while. When it 
stops, the FYPE Y message is replaced with ONE MOMENT PLEASE. At 
this point, the program is initializing itself. In a short time the disk drive 
begins again and the message GETTING PLOT PROGRAM, replaces the 
request to wait a moment. The disk drive stops and the screen goes b 1 k 
for a moment. 

The line PLEASE CHOOSE GRAPH 'YPE appears near the bottom of the 
screen. A new status area appears under the line. You are now in the 
Plot program. The screen looks like the following photograph. 



In the Plot program, the status area is at the bottom of the screen. This 
allows a chart to be displayed along with the status area without destroy¬ 
ing any of the chart. The status area covers up the bottom titles and the 
chart legend but you can turn the status area display on and off at will 
when a chart is displayed. More about this later. 
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THE SELECT MENU 

The menu in the status area is the Select menu. You use it to select the 
type of chart you w int to draw and the series. The menu items indicate 
the six kinds of VTsHYend/VisiPlot charts: LINE, BAR, AREA, PIE, HI-LO, and 
SCATTER. The last item on the menu, NONE, provides a way to exit from 
this menu without choosing a chart type. This exit path comes in handy 
at times, especially after you get to this menu by mistake, which can 
happen when you become very familiar with the menus and start using 
them very fast. 

Move the cursor around within the menu. Read the long prompts in the 
top line of the status area. They explain each choice in a little greater 
detail For example, when the cursor points to LINE, the long prompt says 
CONNECT POINTS IN A LINE. The long prompts are an aid if you forget 
what-a menu item does. 

Move the cursor to LINE and press RETURN. You just elected to draw a 
liue^hart. 

The menu disappears and is replaced with < — — >, SPACE OR 
RETURN. A list of names appears at the top of the screen. This is the same 
list you saw after loading SAMPLE 1. This is a list of the data series that 
are currently in memory. 

The list includes some information about each series. Going across the 
header line, the information items are: 

NAME: This is the name of the data series. Series names should be 

descriptive; they should indicate what data they contain. The 
two series in this list contain some sales data and some history 
data. 

PER: This is the period of the series. Both series in the list have a 

period of 1. This means there is one data point for each time 
period that the series covers. The period can be any value 
from 1 (annual) to 99. Typical values are 1 (annual), 4 
(quarterly), 12 (monthly), and 30 (daily). 

START: This is the starting date for the series. The first data item is for 

the year 1973 in both of the listed series. If the period was some¬ 
thing other than 1, the starting date would include the year 
and the period of the first data point. For example, a starting 
date of 1980 9 with a period of 12 means the 9th period of 1980 
or September, 1980. 
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END: This is the ending date for the series. Everything mentioned in 

the description of START applies to END. 

#: This is the number of data points in the^ series. A series can 

hold a maximum of 150 data points. 

You must select a series from this list. You cannot go further in the Plot 
program unless there is data to plot. Selecting an item from a list is not 
much different than selecting from a menu. You simply move the cursor 
to the item and press the RETURN key. 

Play with the cursor in this list. Note that the right arrow key mgves the 
cursor down the list and the left arrow key moves it up the list. Also note 
that the cursor wraps around the list. If you try to go beyond the bottom 
line of the list, the cursor jumps to the top item. Likewise, attempting to go 
beyond the top of the list causes it to jump to the bottom. The wraparound 
feature lets you move around a long list very rapidly. 

For the purposes of this lesson, move the cursor to the series nc mpd 
FLOPPY SALES. Press RETURN. 

^ THE MAIN PLOT MENU 

The list of series is erased and a new menu appears in the status area at 
the bottom of the screen. This is the Main Plot menu. Most of your work 
with the Plot program is done from this menu. 
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Look at the status area; there are a couple of new items in it. The bottom 
line, which was blank in the previous menu, now says [ LOPPY SALES/LINE 
on the left side and VY.1 B1 on the right side. 

You probably remember that the items on the left side repeat the selec¬ 
tions you made from the last menu and list. You chose to draw a LINE chart 
and selected the series named FLOPPY SALES. 

I 

The meaning of the cryptic notation on the right is quite simple, it speci¬ 
fies the colors in which the chart will be drawn. W1 says the foreground of 
the chart, the actual data, will be drawn in white. B1 says the background 
will be black. You can change the colors and will have a chance to do it 
later. The program always puts a single series chart in black and white. 
The program does not know if you have a color or black-and-white moni¬ 
tor. Black and white shows up very well in both types of monitors. 


The cursor is pointing to the word PLOT and the top line of the status 
area ;ays PLOT TEHE CURRENT SERIES. The current series is the last series 
orjgroup of series chosen from the list. Selecting a series makes that series 
the current series. You can select more than one series and then they all 
become the current series. Selecting multiple series is described in Lesson 
Five. 


Move the cursor around the menu and read the long prompts for the 
other items. Don't press RETURN yet. When you are done looking over 
the Main menu, move the cursor back to the word PLOT. 


DRAWING THE CHART 

With the cursor on PLOT, press RETURN. As the long prompt says, this 
function draws a chart of the current series. 

When you select PLOT, the menu in the status area is replaced with 

SCAl If JG . In a few moments SCALING . is replaced with PLEASE WAIE.. 

You also hear a sound from the computer. The beep is just an added 
indication that the computer got your command and is processing it. 
There is another beep when it completes the chart. 

The Plot program draws the outline of the chart, the Y-axis and the 
X-axis, and puts the values at the tick marks. At this point the status area 
disappears and the data is plotted within the chart. Finally, the legend is 
printed across the bottom and the second beep indicates that the PLOT 
request is completed. The screen should now look like the following 
photograph. 
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Examine the chart. The numbers along the vertical or Y-axis aie J he 
scale of the chart. The numbers along the horizontal or X-axis are tne 
range. Remember that the series listing said this series covered the years 
1973 through 1984. The numbers along the X-axis are 73, 75, and so 
forth. When the range is given in years and there are many plotting 
points, the Plot program abbreviates the range numbers to fit on the axis. 


The line under the X-axis is the legend. The legend contains the name 
or names of the plotted series and, in the case of line charts, shows what 
plotting symbol is used for a particular series. A square box with a dot 
in the center is always used when a single series is plotted. Later, when 
you draw charts with multiple series, you will see the other symbols: the 
diamond and the pound sign. 

The main attraction of the chart is the plotted data. There is a plotting 
symbol for each of the 12 data points in the series. The points are con¬ 
nected by a line. 


HOW TO CONTINUE 

Up to this point, there has been a menu on the screen or some directions 
telling you what you can do. With the menu you always knew you could 
do something. Now there is nothing but a chart; there isn't even a cursor. 
Of course you do not want to stop after making a single chart. The 
VisiTrend/VisiPlot programs are menu driven and you cannot do much 
without a menu. To get the menu back, press any key on the keyboard 
except RESET. 
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No matter what you press, the status area reappears and covers the 
legend. The full-chart is still visible above the status area. The status area 
contains the same menu you used to draw the chart, the Main Plot menu. 

* 

If you want to se t ej&e chart again without the status area, press the ESC 
key. The statusifirea is erased and the chart legend reappears. You can 
switch backhand forth as often as you want. Any key brings the status area 
back and the ESC key erases it. These functions work whenever there is 
a chart on the screen. 

DRAWING A BAR CHART 

If the status area is not on the screen, display it by pressing any key 
except RESET. There are many things you can do to the chart with the 
other A.notions in the Main Plot menu. You can put titles on it, change 
the range and scale, put grid lines on it, and much more. Before looking 
at these features, you should practice what you just learned by drawing 
a different kind of chart. You are going to start over and repeat what you 
did to draw the line chart. The difference is that you are going to draw a 
bar chart. 

Move the cursor to the word SELECT. The long prompt says SELECT A 
GRAPH BY TYPE. Press RETURN. 

As you probably expected, the status area changed and the Select 
menu is displayed. The line chart is still on the screen. You can still erase 
the status area with the ESC key to display the whole chart and legend. 

Move the cursor to BAR. The long prompt says DRAW VERTICAL BARS. 
Press RETURN. 

Instead of the list of series, the status area changes and the Bar menu 
appears. Here you have to select the style of bars with which you want 
the chart drawn. The choices are NORMAL, LER, and RIGHT. LER and 
RIGHT bars are half the width of the NORMAL bars and appear to the left 
or right of the tick marks. Make sure the cursor is on NORMAL and press 
RETURN. The normal, or full-width, bars are centered on the X-axis tick 
marks. The photographs show the Bar menu and the full- and half-width 
bars. 
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Now the list of data series is displayed. Again select FLOPPY SALES and 
press RETURN. 

As before, the list is erased and the status area changes to the Main 
Plot menu. The last chart, the line chart of FLOPPY SALES is again dis¬ 
played. The old chart is kept on the screen until you PLOT the new chart. 
Look at the bottom line of the status area, you will see that it now reads 

FLOPPY SALES/BAR. 

Make sure the cursor is on PLOT and press RETURN. 

The line chart is erased and the sequence you saw earlier is repeated: a 
sound from the computer, SCALING. , PLEASE WAIT. , the chart is drawn, 
and finally the sound indicating the chart is completed. 
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THE PLOTTING OPTIONS . ^ 

The chart on the screen is quite Spartan. In some instances this chart 
would be perfect. But for most applications, you will want to include more 
in the chart. You might want a title that is more descriptive than the 
legend. You might want to explain the values on the Y-axis. You might 
want to highlight some detail in the chart or explain some detail such as 
the drop in sales in 1982. 

Press any key to display the status area. 


The menu item immediately under PLOT is OPTIONS. Move the cursor 
to OPTIONS and press RETURN. The menu in the status area changes. 
This is the Options menu. You are going to use all of these options in this 
lesson. 
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Move the cursor around the menu and read the long prompts; they give 
you a brief idea of what each option does. When you are done examining 
the menu, move the cursor back to TITLE and press RETURN. 

Putting Titles on a Chart 

The status area again changes menus. This is the Title menu. This 
menu does not display long prompts in the top line of the status area. The 
items are descriptive and you won't have any trouble understanding 
them. 
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The first item is EXIT. EXIT provides the means of getting out of this menu. 
The other items in the Title menu perform their function and then return 
to the Title menu. EXIT returns you to the Main Plot menu, not to the 
Options menu. Give it try. To get back to the Title menu, you must select 

OPTIONS and then TITLE. 

Move the cursor to TOP and press RETURN. 

The status area changes. The menu vanishes and the second line con¬ 
tains the word ENTER. The third line is empty. This is a configuration you 
will see often. It means the VisiTrend/VisiPlot program wants you to enter 
some data at the keyboard. The data you enter at the keyboard appears in 
the third status area line. 



Type MY FIRST CHART. If you make a mistake, press the ESC key. 
ESC erases the last character on the line. Press ESC. If the last character 
was a space, you won't see anything happen. Press ESC until you see the 
erasing action of the ESC key. If you press ESC past the beginning of the 
data, the program returns to the Title menu. 


Anytime you have to enter data, the ESC key lets you correct your 
mistakes or change your mind. If you try to correct the line by pressing 
the left arrow key, you will hear a beep from the computer indicating 
that the use of the key is not valid. 


2-13 






VISITREIJD M +VISIPLOT™ S 5 

LESSON ; OME 


APPLE II 

TUTORIAL 


When you finish entering the title, press RETURN. A two item menu 
appears. You have the choice of displaying your title in normal typeface 
or bold typeface. Everything you have seen written on the screen so far 
has been in the normal typeface. Move the cursor to BOLD and press 


RETURN. 



The title appears centered at the top of the chart. Notice that the 
characters are much bolder than the other characters on the screen 
which are in the normal typeface. 
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You can enter a top title as long as 38 characters. If you change your 
mind and want a new top title, just enter a new one. The new title will 
replace the old one. 

The Title menu reappears at the bottom of the screen after the top title 
is completed. 

Notice that the menu allows you to enter one, two, or three bottom 
titles. The bottom titles use the same area used by the legend. A bottom 
title erases the legend line if there is a legend line at the specified location. 

Move the cursor to BOTTOM and press RETURN. Again you are con¬ 
fronted with the status area configuration that requests alphanumeric 
data. Bottom titles can also be 38 characters long. Enter the title DISK 
DRIVE SALES. When you press the RETURN key, the typeface menu 
again appears. This time select the NORMAL typeface. After you select 
the typeface, the - legend line is overwritten by the title and quickly the 
status area reappears. Press the ESC key to erase the status area and 
take a better look at the bottom title. Press any key when you are ready 
to continue with the lesson. 

Move the cursor to LEFT and press RETURN. The Left title can be 18 
characters long. Enter UNITS PER OUTLET. When you press RETURN 
the line is displayed vertically along the left side of the chart, outside the 
Y-axis scale values. The typeface menu was not displayed. The LEFT 
title is only available in the normal typeface. 

The last item in the Title menu is MOVEABLE. The MOVEABLE function 
provides the means of entering a title and moving it to any location in the 
chart. With the MOVEABLE function you can put as many titles as you 
want anywhere in the chart; there is no limit. 

Move the cursor to MOVEABLE and press RETURN. 

Enter PLANT FIRE and press RETURN. 

The entry appears at the middle left of the plotting area and blinks at a 
steady rate. This title can now be moved to any location on the screen. It 
will continue to blink until it is fixed in a permanent location. 
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Moving a Title 

The movement of a title is controlled with the I, J, K, and M keys. Look 
at these keys on the keyboard and you will notice that their relative loca¬ 
tions suggest the four screen directions: 


UP 


LEFT 




DOWN 



RIGHT 


001-004 


Press and release the K key and the blinking title slowly moves to the 
right. You can stop it at any time by pressing the space bar. Try it. To start 
it moving again, press any direction key. While the title is moving, you 
con change its direction by pressing a different direction key. There is no 
need to stop it to change direction. Press the M and let the title move 
down over the chart bars. Notice that it is white when over a black back¬ 
ground and black when over a white background. Let it continue to the 
bottom of the screen. As it passes over numbers and letters, it is difficult 
to read. But you can always tell where it is by the blinking. 

When it reaches the limits of the screen, it keeps trying to move and the 
computer beeps for each attempted move. The beeping continues until 
you stop the movement by pressing the space bar or change the direction 
by pressing another direction key. 

You can increase the speed of the title movement with the number keys, 
1 through 9. The higher the number the faster the title moves. If you do 
not choose a speed, it travels at the 1 rate. 

Press 9, the fastest speed. The title continues in the direction it was mov¬ 
ing but at a faster rate. If it was stopped, it begins moving again, in the 
direction it was last moving. 

With a little practice, you will become adept at moving the title quickly 
to an area of the screen at high speed and then fine tuning the position at 
a slower speed. 

Move the PLANT FIRE title to the short bar for the year 1982. Center 
it across the bar about a quarter of an inch from the top. When you have 
it where you want it, press RETURN to fix it in place. 
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When you press RETURN, the title stops blinking and appears in reverse 
video, black letters on a white background. Press the space bar and the 
title changes, it is now in white letters on a black background. You can 
continue to switch back and forth between normal and reverse video by 
pressing the space bar. When you decide on the style you prefer, press 
RETURN again. The title is now a permanent part of the chart and the 
Title menu returns to the screen. The only way to change it now is to 
redraw the chart. 

Until you pressed the RETURN key the second time, the MOVEABLE 
title could have been erased by pressing the ESC key. 

You learned several things in this section: 

• The 1,1, K, and M keys move a moveable title in the direction indicated 
by their relative location. 

• The number keys, 1 through 9, select the speed at which the title 
moves. 

• Pressing the RETURN key once fixes the title in its current location. 

• The space bar switches the title between normal and reverse video. 

• Pressing the RETURN key the second time makes the title a perma¬ 
nent part of the chart and returns the Title menu. 
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Erasing Moveable Titles 

A MOVEABLE title can be erased at any time by pressing the ESC key 
before the RETURN key is pressed the second time. 

Enter another MOVEABLE title. Move the cursor to MOVEABLE, press 
RETURN, enter JUNK, and press RETURN again. Move the title to a loca¬ 
tion over the bars and stop it. 

Now press ESC. The title vanishes and no harm is done to the bars that 
were under it. 

You can erase the MOVEABLE title after it is fixed in place but before 
the second RETURN that makes it a permanent part of the chart. After 
the title is fixed in place (by the first RETURN), erasing it also destroys 
whatever is under it* that is, if part of the chart or other text is under the 
title, it is erased and a rectangular hole is left in the chart. To remove the 
hole you must rePLOT the chart. 

After the second RETURN, the title cannot be erased. 

Bringing Back the Legend 

The only items remaining in the Title menu are BOTTOM2, BOTTOM3, 

and LEGEND. BOTTOM2 and BOTTOM3 function just like BOTTOM 1 
except that they put titles on different lines. 

LEGEND erases any bottom title lines that cover legend lines and 
restores the original legend lines. Like bottom titles, there can be a maxi¬ 
mum of three legend lines. Only those bottom title lines that covered a 
legend line are erased, the others remain on the screen. You covered the 
one line legend with the BOTTOM 1 title. Press RETURN while the cursor 
is on the LEGEND item. 

Very quickly the status area vanishes, the bottom title is erased, the 
legend line is restored, and the status area returns and covers the legend. 
This happens fast and you might miss it. Press the ESC key to erase the 
status area. Your bottom title is gone and the original legend is on the 
screen. 

Just as a note now, it should be mentioned that the LEGEND function 
works differently with pie charts. When you have a pie chart on the 
screen, the LEGEND function erases the pie chart legend. After the pie 
chart legend is erased there is no way, short of redrawing the chart, to 
reconstruct it. 

Move the cursor to EXIT and press RETURN to return to the Main Plot 


menu. 
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The Scale and the Range 

The range of a chart is the time between the starting date and the end¬ 
ing date and is always plotted on the X-axis (except for a scatter chart). 
The range is stored as part of the data series. The scale is the spread of 
values plotted along the Y-axis. The program determines the scale each 
time a series is plotted. It determines a reasonable-scale that covers the 
range of values in the series. It also decides on the number of divisions 
(tick marks) to display. 

In determining a scale, the program attempts to avoid divisions that 
result in fractional or non-round numbers. When possible, it chooses 
round numbers. For example, with a series that spans the values 0 through 
700, the program divides the Y-axis into seven divisions and labels them 
0, 100, 200,..., 700. It wouldn't choose 11 divisions because that results in 
scale labels of 0, 63, 127, 190, 254, and so on. 


When the Y-axis values are too large to be displayed, the VisiTrend/ 
VisiPlot program scales the values up or down by a power of 10. It then 
displays the Y-axis scaling factor at the top of the Y-axis in reverse video 
(black on white). For example, with a scale of 0 through 100,000, the pro¬ 
gram generates labels of 0, 10, 20, 30; these values are multiplied by 10 to 
the 3rd power or 1000. The following photograph shows a chart with a 
scale factor. 



You can change both the range and the scale when you draw a chart. 
You might want to show only a subset of the range. You might want small 
variations to show up more or to show up less. The scale and range have a 
significant effect on how a person perceives the data in a chart. 
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How to Change the Scale 

We will use a different chart for this portion of the lesson. Go back to the 
Select menu, specify a LINE chart, and select the series FLOPPY DENSITY. 

If you forgot, SELECT takes you back to the Select menu. LINE specifies a 
line chart. FLOPPY DENSITY is one of the series on the list. When the Main 
Plot menu returns, select PLOT and draw the new line chart. 



Press any key to bring back the status area after the chart is drawn. 
Select the Options menu again with the OPTIONS item in the menu. 

One of the items on the Options menu is RESCALE. Move the cursor to 
RESCALE and press RETURN. 

The status area configuration that requests data appears in the status 
area. The prompt asks for a Y-AXIS MINIMUM. The current minimum used 
in the chart is 0, change it to —200. Enter —200 and press RETURN. Next 
you are prompted for the Y-AXIS MAXIMUM. The maximum is currently 
200, change it to 100. Enter 100 and press RETURN. Finally, you are 
prompted for the # AXIS DIVISIONS (2... 12). You can specify any number 
of divisions from a minimum of 2 to maximum of 12. The new scale, —200 
to 100, divides nicely into 6 divisions. Enter 6 and press RETURN. If you 
do not enter a valid number, the RESCALE operation is canceled. 
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To determine the number of divisions, subtract the minimum scale 
value from the maximum value. A good number of divisions is any num¬ 
ber in the range 2 through 12 that evenly divides into the difference. In 
the above example, 100 minus —200 equals 300. 2, 3, 6, and 12 give divi¬ 
sions of 150, 100, 50, and 25. Others, such as 4 and 5, will work but result 
in divisions of 75 and 60 which are not as common as chart units as 25, 50, 
and 100. 


The Main Plot menu returns but nothing else happens. The scale did 
not change. 

You didn't do anything wrong. You must select PLOT again to redraw 
the chart with the new scale. Press RETURN with the cursor on PLOT. 
After the PLEASE WAIT, message, there is a beep from the computer and 
the message DATA OFF SCALE: Y TO DISPLAY appears in the status area. 
This message means that there are data points in the series that are 
outside the scale you specified. This is just a warning that the chart will 
not contain all the data points in the series. If you press the Y key the 
program continues and draws the chart. If you press any other key on the 
keyboard, the PLOT request is canceled. 


Press Y to continue. For each data point that the program cannot put 
on the chart, it sounds a beep. There are two beeps sounded while the 
program draws this chart. The last two points in the series do not fit 
within the scale. 


This situation holds true for line, area, scatter, and hi-lo charts. How¬ 
ever, if you attempt to draw a bar chart that goes off the scale, the program 
stops at the first off-scale bar. The drawing of the chart is terminated with 
the message CAN'T! PRESS ANY KEY. If you think about it, an off scale bar 
chart actually gives incorrect information. A person reading the chart 
wouldn't know that certain bars should continue beyond the top of the 
scale. It is better to rescale and try again than to show incorrect informa¬ 
tion. 


Confusing the VisiTrend/VisiPlot Program 

You can try to confuse the program by giving a minimum scale value 
that is greater than the maximum value. The program assumes that you 
reversed the values and switches them back. If you give the same value 
for the minimum and the maximum, the program uses this value as the 
minimum and sets the maximum approximately 20 percent higher. 


If you give a number of divisions less than 2 or greater than 12, the value 
is not accepted and the program selected value is used. If you don't enter 
any number, that is, just press the RETURN key, the RESCALE request is 
canceled. 
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Aesthetic Charts 

The VisiTrend/VisiPlot program does its best to generate a good scale 
for your chart. There are times, however, when the values it chooses turn 
out poorly. When this happens, you should consider rescaling the chart. 

When you select a scale, the program takes your request literally and 
does not try to change it. You will, at times, come up with some odd¬ 
looking scales. This is especially true if you select a number of Y-axis 
divisions that are not an even divisor of the difference between the 
minimum and maximum scale values. For example, if you set a scale from 
— 200 to 800 with 10 divisions, the labels read —200, —100, 0, 100 and so 
on. But if you pick a scale from —212.39 to 643.22 with 9 divisions, the 
chart, while correct, is quite unaesthetic as you can see in the following 
photographs. 
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How to Change the Range 

Let's start with an unchanged version of the FLOPPY DENSITY series. 
You can choose whether to go back to the Select menu and get a fresh 
copy of the series or change the scale back to 0 to 200 with 10 divisions. 
If you need help with your choice see either "The Select Menu" or "How 
to Change the Scale!' 

Now you should have a FLOPPY DENSITY line chart on the screen that 
looks like the following photograph. 
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Move the cursor to OPTIONS again and press RETURN. 

Now move the cursor to RANGE and press RETURN. 

The status area changes. The top line reads RANGE: 1973 TO 1981 . The 
RANGE menu offers three choices: SET, CLEAR, and EXIT. 



EXIT returns you to the Main Plot menu. 

The SET option specifies that you want to change the range. With the 
cursor on SET, press RETURN. The data input configuration of the status 
area appears. The prompt asks for the MAJOR START (YEAR). Enter 1974 
and press RETURN. The program now prompts for the MAJOR END 
(YEAR). Enter 1990 and press RETURN. The Main menu returns and noth¬ 
ing happens to the chart. Just as you did with the RESCALE option, you 
must select PLOT to see the chart with the new range. With the cursor on 
PLOT, press RETURN. 

You took a year off the front of the series and added nine years to the 
end. You can lengthen or shorten a range. As you change the range and 
take out data points, you might change the scale. If you specify a range 
that does not coincide with any of the data points, you get the message 
CANT! BAD RANGE. A new range must overlap the range of the series by 
at least two points. You cannot completely exclude any series selected for 
a multi-series PLOT. 
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When the program prompted for start and end dates it did not ask for a 
period. If the period is other then 1 (annual), the program prompts for the 
year and the period for both the start and the end dates. 

Select the Options menu again and then the RANGE option. This time 
move the cursor to CLEAR and press RETURN. When the Main menu 
returns, PLOT the chart again. This time it is drawn with the original range. 
The CLEAR function removes a user-defined range and returns to the 
range stored in the series. The CLEAR function does nothing if you have 
not changed the range. 

The Interplay Between Scale and Range 

When you change the range of a chart, the scale is automatically 
recalculated for the data points within the new range. If you change the 
scale with the RESCALE function before or after changing the range, the 
VisiTrend/VisiPlot program does not perform any scale recalculation. 

More About Ranges 

The program calculates the range before it draws a chart. When only 
one series is selected, the resulting range is the range of that one data 
series. But if two or more series are selected, the calculated range is either 
the union or intersection of the ranges of the individual series depending 
on the type of chart. 

The union of ranges means that the earliest starting date and the latest 
ending date are used. The union of ranges is used with line and area 
charts. The intersection of ranges means that oijly those dates that are 
common to both (or all) series are used for the chart range. The intersec¬ 
tion of ranges is used with bar, hi-lo, and scatter charts. 

The maximum number of points allowed in a range is 150 and the mini¬ 
mum is 2. If you try to draw a chart from a set of series whose combined 
range has more than 150 points, you will get the error message BAD 

RANGE: TOO MANY OR TOO FEW POINTS. 

Formatting A Chart 

Display the Main Plot menu (press any key if the status area is not 
on the screen) and select NEW. NEW erases the existing chart and clears 
all options you have set. If you do not select NEW, some options such as 
COLOR and BACKGR, are held over from chart to chart. 



VISITREND M +VISIPLOT™ S 

LESSON ONE 


APPLE II 

TUTORIAL 


Now select LINE and the FLOPPY SALES series. PLOT it. Notice that the 
program draws a line chart with plotting symbols and lines connecting 
the symbols. 

Select OPTIONS. Move the cursor to FORMAT, and press RETURN. The 
Format menu is displayed. The choices are SYMBOLS, LINES, and BOTH. 
All the line charts you have drawn used both symbols and lines. 

Move the cursor to LINES and press RETURN. The Main menu returns. 
Now PLOT the chart again. It is redrawn without the plotting symbols—just 
the lines connect the plotted points. 

Go back to the Format menu (select FORMAT from the Options menu) 
and choose SYMBOLS and redraw the chart again. This time it is drawn 
with the plotting symbols but no interconnecting lines. 

These are the FORMAT options for a LINE chart. The FORMAT option is 
only valid for LINE, BAR, and SCATTER charts. The BAR chart options let 
you select solid bars (like the bars used in the chart you did earlier in the 
lesson), outlined bars, or shaded bars. The SCATTER chart options are to 
plot with points or symbols. No lines are drawn in a scatter chart. The 
following photographs show the BAR and SCATTER chart formats. 
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If you try to select the FORMAT option with any kind of chart other than 

LINE, BAR, or SCATTER, you will get the message CAN'T! NO OPTION HERE. 

You might try the FORMAT options with the BAR and SCATTER charts 
now. 

Drawing Grid Lines 

Go to the Select menu by selecting NEW. NEW cancels all options set 
through the use of the Options menu. Then select LINE, either of the series, 
and finally PLOT. 

Select the OPTIONS item and move the cursor to GRID and press 
RETURN. The Grid menu appears. This menu offers the options of draw¬ 
ing horizontal, vertical, or both horizontal and vertical grid lines. With the 
cursor on BOTH press RETURN. The program draws the grid lines for 
every tick mark that has a label. 



PLOT the series again. There is no need to go to the Select menu, just 
press RETURN with the cursor on PLOT. The program redraws the chart 
without the grid lines. Go to the Grid menu again and draw only the 
horizontal grid lines. 

Go back to the Grid menu once more and select HORIZ. The program 
erases the existing grid lines. This feature operates on the horizontal and 
vertical grid lines. Note that only the grid lines are erased; the added 
lines on the top and right are not erased. 
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You do not have to erase grid lines in the same manner that you drew 
them. You can draw both horizontal and vertical and then erase only one. 
You can later redraw an erased set of grid lines. 

A chart (other than a PIE chart) must be displayed when choosing the 
GRID option. If you select the option when no chart is displayed, you get 

the CANT! NO OPTION HERE message. 

PRINTING THE CHART 

You can print a copy of the chart on a hard copy printer if you have one 
of the supported printers connected to the computer. Before you can print 
a chart, you must have initialized the printer driver as described in the 
section "Printer Support” in the Introduction. 

To print a copy of the chart that is on the screen, move the cursor to 
PRINT and press RETURN. If you have not used the printer during this 
session (which you haven't if you are following the lesson for the first 
time) the program prompts for slot number to which the printer is con¬ 
nected. Usually, the printer is connected to slot 1. Enter the slot number 
and press RETURN. The program immediately proceeds to print the chart 
on the screen. 

THE END OF THE BASICS 

You now have enough experience to examine the remainder of the 
OPTIONS menu. There are three options you haven't used; UNLABEL, 
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BACKGR, and COLOR. These options erase the labels around the chart, 
change the background color, and change the plotting color. There are 
also two options in the Main Plot menu that you have not used: — >MAIN 
and PIXSAVE. These options reload the Storage Management program 
and save a binary copy of the screen image in diskette. 

UN LABEL must be used with a chart displayed, like the GRID option. 
Once you erase the labels with this option, you must redraw the chart 
to get them back. 

The BACKGR and COLOR options are most useful if you have a color 
monitor. See the descriptions of these options in the Reference Section of 
this manual. 


The ->MAIN option prompts with the TYPE Y TO CONFIRM message 
and reloads the Storage Management program if you press the Y key. 
Any other key cancels the request. The data series that you have in mem¬ 
ory are not lost when you change programs. 


The PIXSAVE option saves the screen image in a diskette file in binary 
form. You are prompted to enter a name for the PIXSAVE file. The file is 
stored under that name with .PIX added to it. This binary file can be 
printed at a later time with a program you must supply to match your 
printer. Appendix A contains a sample of such a program. 


The next lesson describes the use of the Storage Management program. 
Following that, Lesson Three covers the Edit functions. 
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USING THE STORAGE MANAGEMENT PROGRAM 


This lesson describes the facilities of the Storage Management program, 
except for the Edit functions which are described in Lesson Three. Lesson 
Two gives you experience and practice using these functions. 


Storage Management is the first program you encounter after booting 
from the VisiTrend/VisiPlot program diskette. Along with creating, load¬ 
ing, and saving VisiTrend/VisiPlot data, the Storage Management facili¬ 
ties provide access to DIF data from other Personal Software products, such 
as the VisiCalc program. With DIF files, you can create and modify data 
with the VisiTrend/VisiPlot facilities and then process that data with other 
products. 


In the last lesson, you used a couple of the Storage Management func¬ 
tions. Depending on your experience with computers, you may or may not 
have known what you were doing. In this lesson you will do more and also 
get a full explanation. 


IF YOU ARE IN THE PLOT PROGRAM 


If you are still in the Plot program from Lesson One, display the Main 
Plot menu. To get to the Main Plot menu: 

• press any key if there is no menu displayed. 

• from the Select menu, select NONE. 

• from the Options menu, select TITLE and then EXIT. 

• from the Title menu, select EXIT. 

To return to the Storage Management program, select — >MAIN. 
You are prompted to press the Y key to verify that you want to change 
programs. 


IF YOU ARE NOT IN THE PLOT PROGRAM 

Load the VisiTrend/VisiPlot program according to the directions in the 
"Loading the VisiTrend/VisiPlot Program" section in the Introduction. 
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THE MAIN STORAGE MANAGEMENT MENU 

After loading the program, the Main Storage Management status area 
appears at the top of the screen. The version number of your VisiTrend/ 
VisiPlot diskette, the copyright notice, and some general directions on 
using the menu follow. 



The Main Storage Management menu lists most of the functions avail- 
able in the Storage Management program. Move the cursor through the 
menu items and read the long prompts on the top line of the status area. 
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DATA AND PROGRAM DISKETTES 


The bottom line of the Main Storage Management menu lists a slot and 
drive number. These items specify to which disk drive the program goes 
when asked to load or save data. 



The slot number is the address of the boot slot on the main circuit board 
(the Apple II mother board) where the disk drive controller is plugged. 
The drive number is either-1 or 2, identifying one of the two drives that 
can be connected to the disk drive controller. The diskette in the disk 
drive identified by these fields is called the data diskette. The diskette 
on which the program is stored is called the program diskette. 

A single diskette can serve both purposes, but it is best to use a separate 
diskette for your data. To use the program diskette, you must remove the 
write protect tab. The use of the program diskette for data, increases the 
possiblity of accidentally destroying the VisiTrend/VisiPlot program on 
the diskette. Your VisiTrend/VisiPlot program diskette contains the 
VisiTrend/VisiPlot programs and some sample data series for practice. 
You used one of the files, SAMPLE 1, in Lesson One. 

HOW THE DATA DISKETTE DRIVE IS SELECTED 

When you load the VisiTrend/VisiPlot program, it determines where 
the data diskette is located. First, it assumes the data diskette is located 
at the same slot address from which you loaded the program. Normally 
this is slot number 6. 


2-34 




APPLE II 

TUTORIAL 


VISITREND™+ V1SIPLOT™ u ^Sj 

LESSON TWO 


The specific drive can be number 1 or 2. If you have a single drive 
system or only one drive connected to the disk controller from which you 
loaded the system, the data diskette drive is number 1. If you have two 
drives connected to the controller in the boot slot, the data drive number 
may be number 1 or 2. When you load the VisiTrend/VisiPlot program, 
part of the program initialization checks if there is a diskette that is 
initialized for use with the VisiTrend/VisiPlot program in drive 2. If there 
is, drive 2 is assigned as the data diskette drive. If there is no diskette in 
drive 2, or if the drive 2 door is open, or the diskette in the drive is not 
initialized, drive 1 is assigned as the data diskette drive. 

For the purpose of this lesson, load the VisiTrend/VisiPlot program 
without a diskette in drive 2. If you have already loaded the program 
with a diskette in drive 2 and the bottom line of the status area says 
DRIVE: 2, do the following: 

• Move the cursor to DRIVE in the menu. 

• Press RETURN 

This is all it takes to change the data diskette drive assignment. 

Now double check and make sure the bottom line of the status area 
reads: 

SLOT: 6 DRIVE: 1 

The slot number, of course, is whatever slot you load from. 


LOADING VISITREND/VISIPLOT DATA 

There are two ways to get chart plotting data into the computer. You 
can create it with the Edit function (which is described in Lesson Three) 
or you can read it from diskette. 


The data on diskette was originally created with the Edit function or 
transferred from some other program as a DIF file. The use of diskettes 
is a convenience. With them, you can save the plotting data and use it 
later. Without them, you would have to recreate the data over and over, 
each time you load the VisiTrend/VisiPlot program. 

After you load the VisiTrend/VisiPlot program and the Storage Man¬ 
agement menu appears, the cursor points to the LOAD function. The long 
prompt reads LOAD SERIES. 


With the cursor on LOAD, press RETURN. 
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The menu disappears and the message READING DIRECTORY. . tempo¬ 
rarily appears in the status area. The disk drive motor begins to run. The 
message in the status area is replaced with SPACE BAR, OR 

RETURN, and a list of names appears under the status area. The cursor 
is no longer in the status area, it is pointing to the top name on the list. 



The names on the list are the VisiTrend/VisiPlot files on the data 
diskette. In this example, the data diskette is also the VisiTrend/VisiPlot 
program diskette. This method is used only to supply data for these lessons; 
you should not put your data on the program diskette. There may be other 
files on the diskette, but the program only lists text files such as VisiTrend/ 
VisiPlot or DIF files. (You may encounter a data diskette that contains 
other text files such as VisiCalc /SS files. If you try to load a non-VisiTrend/ 
VisiPlot or DIF file, you will get the UNABLE TO LOAD: WRONG FORMAT 
message.) Each VisiTrend/VisiPlot file contains from 1 to 16 data series. 
There will be more about files and series shortly. 

You select a file for loading by pressing RETURN or the space bar with 
the cursor pointing to the file name. As described in the Introduction, 
the cursor moves up and down the list when you press the left and right 
arrow keys. 

The last item on the list is (NONE). Selecting (NONE) lets you go back to 
the Main Storage Management menu without loading a file. You may 
need this when you use the LOAD function simply to look at the file list or 
when you accidentally select LOAD. 
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If the whole list of files does not fit on the screen, the last item will be 
(MORE}. Selecting (MORE] displays the next portion of the list. You are at 
the end of the list when the last item is (NONE) and (MORE) no longer 
appears on the list. 

To start from the top of the list again, select (NONE) and, when the Main 
Storage Management menu reappears, select LOAD again. 

The next sections of this lesson assume that the two series in the file 
SAMPLE 1 are in memory. If you did not leave the VisiTrend/VisiPlot 
program after finishing Lesson One, these series are still in memory and 
you should skip to the next section, "Listing the Series in Memory!' If you 
just loaded the program, continue with the next paragraph. 

Move the cursor to the name SAMPLE 1 and press RETURN. 


The message vanishes from the status area and the disk drive motor 
runs again. Characters rapidly flash across the third line of the status 
area. This is the data being loaded from the diskette. After the file is loaded 
into memory, a list of the series in the file is displayed. You have the option 
of CONTINUEing, which returns the Main Storage Management menu, 
or PRINTing, which prints the list on your printer and then returns to the 
Main Storage Management menu. Select CONTINUE. 



You can only load one file at a time. However, you can select LOAD 
again and read another file into memory. Memory can hold a maximum 
of 16 data series or 645 data points, whichever is reached first. If your 
files each hold four series that average less than 40 data points each, you 
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could load four files into memory. If you have a file with five series that 
contain 645 data points, you could only load the one file. 

When the memory limit is reached, the message NO MORE ROOM 
appears on the screen. If the data is in the normal VisiTrend/VisiPlot 
format, a partial load is done, if there is sufficient room in memory. The 
error message still appears. 

LISTING THE SERIES IN MEMORY 

You just loaded a file named SAMPLE 1. 

Move the cursor to LOOKUP and press RETURN. 

The long prompt reads DISPLAY SERIES INFO. A list of two items appears 
under the status area, it is the same list you saw when you loaded the file. 
Most of the list should look doubly familiar. It is the same list you saw 
when you selected a series for plotting in the Plot program in Lesson One. 



If your screen does not look like the photograph, you either loaded the 
wrong file or had previusly loaded series in memory. If this occurs, select 
CONTINUE, move the cursor to CLEAR and press RETURN. Move the 
cursor to (KEEP NONE) and press RETURN. This clears all series from 
memory. Now go back to the section "Loading VisiTrend/VisiPlot Data/ 
continue from that point. If your screen looks like the photograph, continue 
with the next paragraph. 
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Just to review, the columns in the list are the names of the series, the 
period of the data (the frequency of data points per year), the starting 
date, the ending date, and the number of points in the series. 

This list has an additional line at the bottom that was not present in the 
Plot program list. It reads: 

SERIES: 2/16 DATA POINTS: 21/645 

This line shows how much room is occupied. Memory holds a maximum 
of 16 series or 645 data points. You loaded two series from the file SAMPLE 
1. That leaves room for 14 more. The two series contain, respectively, 12 
and 9 data points for a total of 21. Memory can hold a maximum of 645 
data points; there is room for 624 more data points. 

When you are done examining the LOOKUP list, select CONTINUE to 
return to the Main Storage Management menu. Alternately, you may 
select PRINT to print a copy of the list before returning to the Main 
Storage Management menu. 

FILES AND SERIES 

Some users, especially those who are new to computers, get confused 
about files and series. 

The VisiTrend/VisiPlot program uses floppy diskettes as a permanent 
storage medium. On these diskettes, the program stores data, any kind of 
data, in units called files. A file is nothing more than a collection of data 
that is identified by a name called a file name. 

When the VisiTrend/VisiPlot program processes data in the computer, 
it uses a unit of data called a series. A series is a collection of data points 
for a single chart. A series has a name and is identified by that name, just 
like a file. The figure shows the relationship between files and series. 




- SERIES 

- SERIES 

- SERIES 

- SERIES 

- SERIES 

- SERIES 
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After a file is brought into memory, the series in the file have no further 
connection with the file. They become independent units. 


Often there are several series with related data that are used together. 
For example, for a business you might have series showing sales, costs, 
gross and net profits. You might have data to show the breakdown for a 
whole year and also yearly or quarterly data to show growth over the 
past several years. 


All this data is related and probably used together. Many of these series 
would be plotted on the same chart. Rather than store each series as a 
file, the VisiTrend/VisiPlot program provides the means of combining 
up to 16 series (or series containing up to 645 data points) in the offline 
storage unit—the floppy diskette file. To access the data for these series, 
either for updating or plotting, you load a single file instead of many files. 

The points to remember are: 

• Both files and series have names 

• Files are units of storage on diskettes 

• Series are units of data in memory 

• A file can hold up to 16 series or 645 data points 


CHANGING THE DATA DISKETTE ADDRESS 

It was mentioned in the beginning of this lesson that the VisiTrend/ 
VisiPlot program determines the slot and drive address for the data disk¬ 
ette. Many times you may want to change the address. You may have 
forgotten to put the data diskette into drive 2 when loading the program. 
You may have more than two drives and want to use drives not connected 
to the same slot as the drive from which you loaded. There are many 
circumstances in which you will have to change the address. 

The program lets you change the slot and drive addresses individually. 

Changing the Drive Address 

To change the data diskette drive address, move the cursor to DRIVE 
and press RETURN. The drive number in the bottom line of the status 
area changes. If it was 1 it changes to 2 and if it was 2 it changes to 1. 

Remember, the LOAD, SAVE, DELETE, and INIT functions read (load) and 
write (save) to the data diskette in the specified drive and slot. The 
PIXSAVE function in the Plot program also uses this drive and slot. 

After the change the cursor returns to its initial position at LOAD. 
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Always check the drive and slot numbers before issuing a function that 
uses the data diskette slot and drive addresses and change them if neces¬ 
sary. If you try to LOAD from a non-existent or empty drive, you get the 
error message; CANT! ERROR: DISK I/O. 

Changing the Slot Address 

To change the data diskette slot address, move the cursor to <MORE> 
and press RETURN to display the Main Storage Management menu 
extension and then to SLOT and press RETURN. 

It is only possible to change the slot address if there is more than one 
disk drive controller in the computer. If there is only one controller, the 
SLOT function has no effect. 


If there are other controllers, they must be in slots immediately adjacent 
to the boot slot (usually number 6). The SLOT function does not operate 
with configurations where there is a gap between controller slots such as 
6 and 4. With controllers in slots 5 and 6, the SLOT function changes the 
data diskette slot address to 5 if it is currently 6 and to 6 if it is currently 5. 


DISK ERRORS 


You should never get a disk error. But they sometimes happen. They 
are often caused by something you overlooked. You might change the 
disk drive and forget to put a diskette in the drive. You might leave the 
drive door open. You might put the wrong diskette—one that is not 
initialized for VisiTrend/VisiPlot use—in the drive. A diskette might get 
damaged through mishandling, accident, or disk drive malfunction. 


In all of these cases, you will get the error message CAN'T! ERROR: DISK 
I/O. This message is accompanied by a beep. The message remains in the 
status area until you press any key. The function you requested is not 
performed. 

If you get the CAN'T! ERROR: DISK I/O message make sure: 

• The correct slot and drive numbers are set 

• The diskette is in the drive 

• The diskette has the correct side facing up 

• The drive door is closed completely 


Then try the operation again. If you still get the error message, try the 
diskette in a different drive if you have multiple drives. You might also try 
a different VisiTrend/VisiPlot data diskette. Make sure you use a data 
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diskette for which you have a backup. It is always a good idea to have 
backup of your diskettes; it is a necessity when you ae having problems. 

If you continue to get the error, see the troubleshooting guide that came 
with your computer and disk drives. 

SAVING DATA 

After you enter new data or modify existing data with the Edit function, 
you will want to save the data on a diskette for use at a later time. The 
SAVE function provides the means of doing this. 

Move the cursor to SAVE and press RETURN. 

A different menu .appears in the status area. The options are NORMAL 
and DIF. This menu lets you choose the format in which the data will be 
saved. If the data is to be used only with the VisiTrend/VisiPlot program, 
you will want to save it in the NORMAL format. 



The DIF (for Data Interchange Format) option stores data in a format 
that can be used by other Personal Software programs, such as VisiCalc. 

With the cursor on NORMAL, press RETURN again. 

The menu area contains the directions <—, — >, SPACE BAR, OR 
RETURN. Below the status area the program displays a list of the series 
currently in memory. At the bottom of the list are the items (NONE) and 
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(ALL). The series listed should be FLOPPY SALES and FLOPPY DENSITY, the 
ones you loaded from the SAMPLE 1 file. 



You can cancel the SAVE operation by moving the cursor to (NONE) 
and pressing RETURN. 

To SAVE data, you have a few choices. You can move the cursor to (ALL) 
and press RETURN, which writes all the series currently in memory out 
to the data diskette. But if you only want to save a single series, you can 
move the cursor to the series name and press RETURN. Finally, you can 
save some of the series in memory by moving the cursor to the name of the 
first series to be saved and pressing the space bar. When you press the 
space bar, an asterisk (*) appears next to the series name. The asterisk 
means the series is selected to be saved when RETURN is pressed but it is 
not yet saved. 


You can change your mind up to the time you press RETURN. If you 
don't want to save that series after all, press the space bar again. The 
asterisk disappears. The series is no longer selected for saving. Pressing 
the space bar again selects the series again. You can select as many or as 
few series as you want in this manner. 


When you select series in this manner, they are all saved to the data 
diskette when you press RETURN, including the series to which the cursor 
is pointing whether or not it has an asterisk next to it. If the cursor is on 
(ALL) or (NONE), they have precedence regardless of the number of 
asterisks in the list. 
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For the purpose of this lesson, move the cursor to (ALL] and press 
RETURN. The disk drive makes a whirling sound and the status area says 
READING DIRECTORY.. The directory of the files currently on the diskette 
is listed under the status area. It is the same list you saw when you LOADed 
SAMPLE 1. But there is a slight difference. In the LOAD list the last item 
was [NONE] and in this list it is (NEW FILE]. 

You now have a choice and a responsibility. You must select the file to 
which the selected series are to be written. It is a responsibility because, if 
you select an existing file, the data in it is destroyed and the selected series 
are stored in it. You must be careful not to erase any data you want to 
keep. 

Usually, after you have created a new data series with the Edit function, 
you will want to put it in a new file. If you have updated information in an 
existing file, you will probably want to replace the old data with the new. 
Remember, the selected series replace all the data series in the file, not 
just those of the same name. For example, if you load a file that contains 
series A, B, and C, modify series B, and then save series B to the same file, 
the file will contain only series B because you did not save series A and C. 

Also remember that all selected series are saved in the same file 
regardless of which file they were loaded from. 

It is good practice to save all data in new files. If after a period of time 
you find you don't need the old data, you can erase the old file with the 
DELETE function which is described later in this lesson. 

For now, select (NEW FILE] and press RETURN. 

When you choose to create a new file, the program prompts for a file 
name. Enter a name that is different from all other names on the diskette 
and press RETURN. You will get an error message if a file by that name 
already exists on the data diskette. 

If you have followed the directions, you just tried to write to the program 
diskette in drive 1 of the boot slot. And you got the error message, CAN'T! 
ERROR: WRITE PROTECTED. Your diskette is write protected: you cannot 
write on it. This protects the program diskette from being accidentally 
destroyed. Press any key except RESET to redisplay the menu. 

There was no need to save the series you selected because there is 
already a copy of them in the file named SAMPLE 1. You didn't make 
any changes to them because you have not yet used the Edit function. 
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Remember to check the data diskette drive assignment before starting 
a SAVE. The data diskette drive number cannot be changed after you start 
the SAVE. If you forget to change the drive number, cancel the SAVE. 

You can cancel a SAVE function by selecting (NONE) when the list of 
series is displayed. If you go beyond that point before deciding to cancel, 
you can select (NEW FILE) from the list of files and enter a RETURN without 
a name when prompted for a file name. The lone RETURN is an invalid 
response that cancels the function. 

CREATING A DATA DISKETTE 

Before you can perform a successful SAVE, you must create a new data 
diskette. A data diskette is any diskette that is initialized by the VisiTrend/ 
VisiPlot INIT function or by the DOS 3.3 INIT (Initialize) command. See 
The DOS Manual for information on initializing diskettes with DOS 3.3. 

To use the VisiTrend/VisiPlot INIT function, move the cursor to <MORE> 
and press RETURN. The remaining Storage Management functions are 
displayed. Move the cursor to INIT and press RETURN. 

You are prompted to put the diskette to be initialized into the data disk¬ 
ette drive. Put the diskette in the drive, close the door, and press RETURN. 
If the diskette is already initialized, you are given the opportunity to cancel 
the operation. The INIT function destroys all the data on the previously 
initialized diskette. 

If you try to initialize the VisiTrend/VisiPlot program diskette, the INIT 
function detects it and automatically cancels the operation without your 
intervention. 

A diskette initialized with the INIT function has Apple DOS 3.3 on it but 
does not have a HELLO program, therefore, you cannot boot from a 
VisiTrend/VisiPlot program initialized diskette. 

When the INIT function is complete, you are returned to the Main 
Storage Management menu, not to the extension menu from which you 
selected the INIT function. 

After you have created an initialized diskette, you can repeat the pre¬ 
ceding section on saving data and actually SAVE the data. If you have a 
two drive system, put the initialized data diskette in drive 2 and change 
the data diskette drive number with the DRIVE function. If you have a one 
drive system, remove the program diskette and put the data diskette in 
Drive 1. The program diskette does not have to be in Drive 1 until you load 
the Plot program. When the program diskette is needed but not present, 
you are prompted to put it into Drive 1. 
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CLEARING SERIES FROM MEMORY 

When you SAVE data on a diskette, the copy of the data in the computer 
memory is not erased, it remains there. There are times when you will 
want to eliminate some or all of the series from memory to make room for 
other series. After you have saved new and modified series on diskette, 
you may want to load some others. You may have to make room for the 
new data you want to load. 

The CLEAR function erases some or all of the series from memory. 
Move the cursor to CLEAR and press RETURN. The menu is replaced 
with the direction SELECT SERIES TO CLEAR. It is important to remember 
that you must select the series you want to erase, not the ones you want to 
keep. 

Again, a list of the series in memory is displayed under the status area. 
Along with the series names there are two extra options: (KEEP ALL) and 
(KEEP NONE). The former erases nothing from memory, in effect, it cancels 
the CLEAR function. The latter erases everything from memory. 

You can erase a single series by moving the cursor to it and pressing 
RETURN. You can erase two or more series by moving the cursor to the 
name and pressing the space bar. Just like the SAVE function, the series 
name is marked with an asterisk (*) indicating the series is to be erased. 
Pressing the space bar again eliminates the asterisk. You can mark as 
many series with an asterisk as you wish before pressing RETURN. 
Remember, the series to which the cursor is pointing is also erased when 
you press RETURN whether it has an asterisk or not. You should leave the 
cursor on the last series to be erased. 

You are going to clear the series FLOPPY SALES from memory. Remem¬ 
ber, this has no effect on the copy of the series that is on diskette in the file 
SAMPLE 1. Move the cursor to FLOPPY SALES and press RETURN. 

After you press RETURN, the program displays a list of the remaining 
series in memory, just as it does for the LOAD and LOOKUP functions. You 
can CONTINUE which returns to the Main Storage Management menu 
or PRINT the list and then return to the Main Storage Management menu. 



APPLE II 

TUTORIAL 


VISITREND ™ + VISIPLOT™ gggj? 

LESSON TWO 


CALLING THE PLOT AND VISITREND PROGRAMS 

When you are done LOADing and EDITing data, you normally want to 
go to either the Plot or the VisiTrend program. The — >PLOT option calls 
the Plot program from the program diskette and reads it into memory, 
overlaying the Storage Management program. The — > TREND option 
calls the VisiTrend program from the program diskette and reads it into 
memory, overlaying the Storage Management program. 

You have already seen what happens when you call the Plot program. 
You used this function in Lesson One. 

In this lesson we will review the procedure but with the VisiTrend 
program. 

Move the cursor to > TREND and press RETURN. 

The menu disappears and you are given a chance to change your mind. 
You are prompted to press the Y key to verify that you do in fact want to 
leave the Storage Management program and load the VisiTrend program. 
If you press any key exept Y, the request is cancelled and the Main 
Storage Management menu is redisplayed. Press the Y key and the 
process of loading the VisiTrend program begins. 

When loading the Plot program, you must LOAD data into memory from 
diskette or create it with the EDIT functions; you cannot load the Plot pro¬ 
gram if you have no data to plot. If you try the program issues the NO 
ACTIVE SERIES error message and cancels the — >PLOT request. You can, 
however, enter the VisiTrend program without first loading data. The 
VisiTrend program contains the same EDIT functions that are available 
in the Storage Management program, therefore, you can create data 
series in that program. 

When the VisiTrend program is loaded, the Main VisiTrend menu is 
displayed. Move the cursor to — >MAIN and press RETURN. Now the 
process begins in reverse. You are prompted to verify that you want to 
leave the VisiTrend program and return to the Storage Management 
program. Press the Y key and after the loading process is completed, the 
initial Storage Management menu is again displayed. 
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KEEPING DATA WHEN CHANGING PROGRAMS 

When you call the Plot or VisiTrend programs, you usually have one 
or more series in memory. (When going to Plot, you must have data in 
memory.) This data is preserved in memory when you change programs. 

To see for yourself that the data is kept, move the cursor to LOOKUP. 
Look at the list and remember what is on it. Now load the Plot program 
and select any chart type from the Select menu. Compare the list of series 
with the list from the LOOKUP function. They are identical. No data was 
lost in the transition. 

Now go back to the Storage Management program. Do a LOOKUP again 
and you will find that the list has not changed. You can also go to the 
VisiTrend program and select the LOOKUP function. The data remains 
no matter which program you load. 

DELETING FILES FROM THE DATA DISKETTE 

As you create new data series and modify old ones, your data diskettes 
will fill up. Some of the data will be old series that contain out of date infor¬ 
mation and some will be series for which you no longer have any need. 

For this part of the lesson, make sure the data diskette you created with 
the I Nil function is in your data diskette drive. This is drive 2 if you have 
multiple drive system and drive 1 if you have a single drive system. 

Also make sure that the correct slot and drive are listed in the bottom 
line of the status area. 

The DELETE function erases these files from your data diskettes. This 
function is on the Main Storage Management menu extension. Move the 
cursor to <MORE> and press RETURN. When the menu extension is 
displayed, move the cursor to DELETE and press RETURN. 

The READING DIRECTORY, message is displayed in the status area as 
the data diskette drive begins running. The list of files on the diskette is 
listed below the status area. Select a file for deletion in the same manner 
that you selected a file for loading or saving. Move the cursor to the file 
name and press RETURN. Because this function permanently erases files, 
you are prompted to verify that you did, in fact, intend to erase a file. You 
must press the Y key to continue the DELETE function. If you press any 
other key, the function is cancelled. 

You will get an error message if the data diskette is write protected. 
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RETURNING TO THE MAIN STORAGE 
MANAGEMENT MENU 

When you go to the extension menu, the functions you have used so far, 
return you to the Main Storage Management menu. If you call the 
extension menu and decide not to perform any of the available functions, 
you can return to the Main Storage Management menu by selecting the 
MAIN option. This option simply returns you to the Main Storage Manage¬ 
ment menu. 

GETTING OUT OF THE VISITREND/VISIPLOT 
PROGRAM 

There is one remaining option in the extension menu that has not been 
mentioned, QUIT. This option exits the VisiTrend/VisiPlot program and 
puts you into Applesoft Basic. The Applesoft prompt (]) is displayed. The 
copy of the VisiTrend/VisiPlot Storage Management program is cleared 
from memory. To load the VisiTrend/VisiPlot program again enter the 
command RUN INIT. 

LOADING VISICALC DATA 

This section describes how to move data between the VisiCalc program 
and the VisiTrend/VisiPlot program. If you do not use both of these 
products or have no need to transfer data, you should skip this section 
and go to the section "In Summary!' 

You can load and plot VisiCalc data with the VisiTrend/VisiPlot facili¬ 
ties. The VisiCalc data must be saved in a DIF file. This means that 
interchange between the two products is only possible if you have a copy 
of the VisiCalc program at a version number higher than 1.37. 

You must save the VisiCalc data that is to be plotted with the /S# 
command. The stored data should be a sequence of data values that are 
meaningful to plot. For example, the data items in a single row or column 
are usually related to each other. 

You can use rows or columns of VisiCalc data in VisiTrend/VisiPlot 
charts. Single or multiple rows and columns can be used. Each row or 
column is treated as an individual data series. Rows of data use the label, 
if there is one, in the first (left most) field as the series name. Columns use 
the top field as the series name. If the first field in either form is not a label, 
the VisiTrend/VisiPlot program creates a name for each series in the 
sequence SERIESO, SERIES 1, etc. Label fields occurring later in the 
sequence are converted to 0. 
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Data from the VisiCalc program, while in a format acceptable to the 
VisiTrend/VisiPlot program, does not contain all the information the 
Storage Management program expects. It does not contain a period or a 
start date. When you load VisiCalc data, you are prompted for the 
missing items. 


The following exercise loads data from the personal budget example in 
Lesson Three of the Apple II and the Apple II Plus VisiCalc manual. If 
you did the exercise in this lesson, you stored the final sheet on diskette 
under the name PERSONAL BUDGET. Follow these instructions to create 
a DIF file of the UTILITIES data in the budget sheet. 



1. Move the cursor to A6, the UTILITIES label. Row labels, when 
included in the DIF file, become series names in the VisiTrend/- 
VisiPlot program. If the label spans the VisiCalc columns, only the 
first column is used, the second column is treated as a zero value. The 
cursor location marks the upper left corner of the rectangle of data to 
be saved. The lower right corner is specified later. 

2. Enter the /S# command to save the data in the DIF format. 

3. Specify SAVE (S). 

4. Save the data under the name UTIL.DIF. It is advisable to use suffixes 
such as DIF, VC, and VP to distinguish the format in which different 
files are stored. 

5. Specify a lower right corner of M6. 

6. Enter an R to specify that the data be saved in rows rather than 
columns. 
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Load the VisiTrend/VisiPlot Storage Management program. Place the 
VisiCalc data diskette in the VisiTrend/VisiPlot data diskette drive. Select 
the LOAD function. 

The file is loaded in the normal manner, just as VisiTrend/VisiPlot data 
files are loaded. One of the files is named UTIL.DIF. Move the cursor to 
this file name and press RETURN. 

The loading of the file begins. In a few moments, the disk drive stops 
and the program prompts for a period for the data series. Enter 12 because 
the data in this file is on a monthly basis. Next you are prompted for a 
major start date (year). Enter 1980. Finally, you are prompted for a minor 
start date (period). Enter 1 for January. The disk drive begins again and 
the loading of the data is completed. 

When the LOAD is completed, the program displays the list of series in 
memory. The file contained a single data series named UTILITIES. The 
series name is taken from the label in the VisiCalc row. If you had not 
saved the label along with the data, the VisiTrend/VisiPlot program would 
have created a name for the series. 


You can go to the Plot program and create a chart of the UTILITIES 
data from your VisiCalc worksheet. You can also modify the data with the 
VisiTrend/VisiPlot Edit functions (described in Lesson 3). 


After modifying the data with the Edit functions, you can return to the 
VisiCalc program and put the data back into the worksheet. Note, how¬ 
ever, that data saved in DIF does not contain the formulas, if any, in the 
worksheet. The row you used in the preceding exercise did not contain 
formulas, it contained only values. You can load this data and overlay the 
VisiCalc worksheet with no effect on the function of the sheet. 


The VisiTrend/VisiPlot series name is not put back into the VisiCalc 
file as a row label. You must read the data into the value fields, not the 
label fields. Because the series name is not used, the VisiCalc label will be 
destroyed. 

Formulas are not stored with data written to a DIF file. Therefore, no 
formulas are put into the worksheet when a DIF file is loaded with the 
/S# command. If you do this, the worksheet will look correct and values 
that depend on the new data will be correct. But changes to other values 
in the worksheet will not affect the newly loaded DIF data, because there 
are no formulas. 


The last point is important enough to repeat. The /S# command does 
not load or save VisiCalc formulas, only data values. 
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If you wish to create your own DIF files for use with the VisiTrend/ 
VisiPlot program, see the Programmers Guide to the Data Interchange 
Format, document number SATN-18, which is available from the DIF 
Clearinghouse, P.O. Box 527, Cambridge, MA 02139. 

IN SUMMARY 

This completes the Storage Management lesson except for the EDIT 
function which is described in Lesson Three. You have used all the other 
Storage Management functions. You might want to go back to the LOAD 
function and look at some of the other files on the program diskette. 

If you have any trouble with a function, look it up in the reference 
section or return to the part of the lesson in which it was described. 

The next lesson covers the use of the EDIT function which lets you create 
and modify data series. 



APPLE II 

TUTORIAL 


VISITREND M +VISIPLOT™ g 

LESSON THREE 


LESSON THREE 


USING THE EDIT FUNCTION 

The VisiTrend/VisiPlot Edit function has two major purposes: 

• Creating new data series 

• Modifying existing data series 

The Edit function is available in the Storage Management program and 
in the VisiTrend program. The functions and commands available in both 
are identical. An important difference to keep in mind when creating 
new or modified series with the VisiTrend Edit function is that you must 
return to the Storage Management program to SAVE the series on diskette. 

This lesson uses the Edit function in the Storage Management program. 
In the VisiTrend program, entry to the function is through EDIT in the 
Main VisiTrend menu. 


After loading the VisiTrend/VisiPlot program, select the EDIT function 
from the Main Storage Management menu by moving the cursor to EDIT 
and pressing RETURN. There is no need to LOAD a file, this lesson is 
devoted to creating a new data series. If you already have some data 
series is full, that is, if it has 16 series in it or 645 data points, you will have 
to CLEAR some of them before continuing with this lesson. The lesson 
assumes that there are no series loaded from this point. 


USING EDIT 


After selecting the EDIT function, you are prompted to select a series 
from the displayed list. The message in the status area, which you have 
seen before, says you can use the arrow, space bar, and RETURN keys. 
You did not LOAD a file, so there are no series names in the list, only 

(NEW SERIES) and (NONE). 
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(NONE), as it does with other functions, returns you to the Main menu. 

In this lesson you are going to enter the data for a series called FIRST. 
Move the cursor to (NEW SERIES) and press RETURN. The status area 
changes to the data entry configuration and prompts for a series name. 

Type FIRST and then press RETURN. Remember, you can correct typ¬ 
ing mistakes with the ESC key. The ESC key backs over the last character 
and erases it. 


Next the program prompts for the period of the new series. The prompt 
lists the current period that is being used by the program. If you have not 
done any editing or working with series up to now in this session, the 
period will be 1. After you have worked with a file, the period from that 
file is used. For example, if you had just finished working with a file that 
had a period of 4, the current period would be 4. 

For now select a period of 1 by typing 1 and then pressing RETURN. 

Next you are prompted for the starting year of the new series. Enter 
1966 and press RETURN. If the period had been other than 1, you would 
also be prompted for the starting period. A series can begin at any period 
in its starting year. 

If you had not entered a date and had only pressed RETURN, the date 
0 would be used. The program makes a choice if it can when you do not 
enter anything. When it cannot make a choice, it cancels the function or 
continues to ask for data, whichever is appropriate. 
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Finally, you are prompted for the first value in the new series. Now the 
bottom line of the status area contains DATE and FIRST, as column headers. 
There is a cursor in the column headed by the series name. 

The first value for the series is 23. Enter 23 at the keyboard and press 
RETURN. Note that the value appears in the third line of the status area 
until RETURN is pressed. In this location, you can correct it with the ESC 
key. When you have it correct and press RETURN the value moves into 
the cursor location under FIRST. The starting date appears opposite the 
value in the DATE column. 



The status area changes, it now reads USE <ESC> FOR COMMANDS. 
This completes the initial sequence when entering a new series. If you 
had selected an existing series, you would have come immediately to this 
point in the program. The only difference being that a series, or the first 
20 data points of the series, would be displayed on the screen. 

At this point you can add more values to the end of the series or call the 
Edit command menu. For now you should add some more values to the 
series named FIRST. After the series is complete you can use the Edit 
commands on it. 


Adding Values to the Series 

To add a value for the year 1967, press the right arrow key. The date 
1967 appears under 1966 and the cursor moves down one line. Type 28. 
Again the value appears on the third line of the status area. Press RETURN 
and the value appears in the cursor next to 1967. 
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Gaps are not allowed in the date sequence. The program automatically 
adds 1 to the date for each new entry. If the period is 1, the year is incre¬ 
mented by 1. If the period is other than 1, the period is incremented and 
the year is incremented when the period goes full cycle. 

To add the next few values, repeat the preceding process. Press the 
right arrow key, enter the data, and press RETURN. Enter the values 33, 
37 and 41. Note that a solid bar separating the dates from the values 
appears after you make a couple of entries. 

There is a shortcut method for entering new data. Press the right arrow 
key again to show the date 1971 and enter 44 but do not press RETURN. 
Instead, press the right arrow key again. The value, 44, moves to the 
correct place and the cursor moves down a line to the next date. 

Add the remaining values in this manner. Press the right arrow key 
and enter the value. Add 44, 53, 61, 75, 64, 73, 82, and 79 to the series. 

After the last value, the cursor is below the list with the date 1980. We 
don't have a value for 1980, so press the left arrow key. The cursor moves 
back up to the 1979 value and the 1980 date disappears. 

Replacing a Value 

You can move the cursor up and down the list with the arrow keys. In 
this list the cursor does not wrap around. A little later you will use a rapid 
means of moving the cursor in a large series. 

You can replace a value simply by moving the cursor to the value that 
is to be replaced and entering the new value. The current value at the 
cursor location is replaced by the new value when you press the RETURN 
or arrow key. 

Move the cursor to the year 1969 which has a value of 37 . This value 
should have been 39.9. Type 39.9 and press the RETURN or either arrow 
key. The old value is replaced. 
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THE EDITOR COMMANDS 

You have been working at the data entry level of the Edit function. To 
leave this level and go to the command level, press the ESC key. The Edit 
command menu appears. 



The Edit command menu provides many functions. With it you can: 

• JUMP to a specific year (and period) within the series 

• INSERT new data points between existing data points 

• DELETE existing data points 

• FORMAT the manner in which data is displayed 

• PRINT the contents of a series 

• UNDO (erase) all changes made to a series 

• FILL areas of a series with values generated by predefined algorithms 

• EXIT to the Storage Management Main menu and save the work you 
have done 

• Change the specifications (SPECS) of a series 

• Return to the entry level (EDIT) 


Leaving the Edit Function 

The EXIT option returns to the Main Storage Management menu. When 
you exit by this route, the work you created or modified is saved. Move the 
cursor to EXIT and press RETURN. The Main menu replaces the Edit com¬ 
mand menu and the listing of the series is erased. 
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To see that you have created a series, select LOOKUP. The list shows that 
there is a series named FIRST with a period of 1. It begins in 1966, ends in 
1979, and has 14 data points. Press RETURN to continue. 

Returning to the Edit Function 

Select EDIT again. This time there are three items in the series list, the 
same entries you saw earlier plus the series you created. Select the new 
series, FIRST, and press RETURN. 

This time you don't have to enter a name, period, or starting date. The 
contents of the series are listed. The status area contains the USE <ESC> 

FOR COMMANDS message. 

Using the Edit Commands 

The following sections show the use of the Edit commands. For each 
section you will begin in the entry level. The entry level is that part of the 
function in which you can input initial data to the series. While you are in 
the entry level, the status area contains the message USE <ESC> FOR 
COMMANDS. To begin each section, press the ESC key and then move 
the cursor to the subject command. 



In the following section describing the JUMP command, press ESC and 
then press RETURN. The cursor is located at JUMP when you enter the 
command menu. 
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Jump—Moving from Point to Point 

The JUMP command lets you move from date to date in the series 
without repeatedly pressing the arrow keys. Move the cursor to JUMP and 
press RETURN. 

The prompt says <— TOP — > BOTTOM, YEAR. If you enter a date, the 
cursor moves to that date. If the series has a period other than 1, you are 
prompted for the period also. If the date is currently displayed, the cursor 
simply jumps to that position. If it is not displayed, the screen is erased 
and is rewritten with the specified date at the bottom or top of the screen 
(depending on the direction you are moving in the series) and the cursor 
on it. 

If the date does not exist in the series, there is a beep and the date is 
not accepted. At this point, you should enter a valid date. 

Pressing the right arrow key moves the cursor to the last entry in the 
series. The left arrow key jumps to the first entry in the series. 

After the jump is completed, you are returned to the Edit function 
entry level. 

To exit the JUMP command without making a move, press the RETURN 
key twice. 

Insert—Adding An Entry 

The INSERT command lets you add a new values at the current cursor 
location in the series. Insertion with this command works just like adding 
a value except that it operates anywhere in the series, not just at the end. 
The command opens up the series at the cursor location. All values at and 
below the cursor are pushed ahead to the next date. 

Type the new data and press RETURN if you are inserting a single 
value. If you have more than one value to insert, type the new data and 
press right arrow key. Press RETURN after the last entry. You can correct 
errors with the ESC key before pressing the RETURN key or the right 
arrow key. Pressing the RETURN key returns you to the entry level. 

Delete—Erasing a Data Point 

The DELETE command erases one or more values beginning with the 
current cursor location. The range to be deleted is listed in the status area. 
You can abort the DELETE command by pressing the ESC key. 

When you select the DELETE command, only one data point, the one at 
the cursor, is listed for deletion. Moving the cursor, in either direction, 
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broadens the range of values to be removed from the series. As you move 
the cursor, the range lisfed in the status area changes. If you move the 
cursor beyond the end of the series, the DELETE command is cancelled. 

You can DELETE in either direction from the original cursor position. 
However, the initial cursor location will always be the beginning or end of 
the range to be erased. 

Pressing RETURN when you have defined the correct range removes 
the selected values from the series. The values below the removed area 
move up to fill the new empty dates. 

You are returned to the entry level. 

To exit the DELETE command without making a change to the series, 
press the ESC key. 

Specs—Changing the Series Specifications 

The SPECS command provides the means of changing the name, 
period, or start date of the series. This command displays a new menu. 
Selecting the menu displays prompts for new data to replace the current 
series name, start date, or period. 



When you change a series specification, the change takes place imme¬ 
diately and is shown on the screen. If you change the name, the new name 
replaces the old name as the value column header. A new period or 
starting date causes the date and/or period columns to be changed on 
the screen. The existing data points do not change, only their date and/or 
period. 
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You can respond to the prompts for data by pressing the RETURN key 
without entering data. When you do this, the program assumes values. 
For the NAME function, it generates the name SERIESn, where n is a 
number from 0 through 15. For the PER function, it uses the current period. 
For the START function it uses the date 0. 

Format — Changing the Data Display 

The FORMAT command lets you specify how the data values in the 
series are to be displayed. You can select the fixed format and specify 
the precision (number of decimal places from 0 to 6) and column width 
(total number of digits displayed from 6 to 15). You can also specify that 
values be displayed in the floating format. 

The command first prompts for a precision (0 to 6) or the floating point 
format (—1). Pressing RETURN retains the current format and precision. 
Next it prompts for the column width which can be from 6 to 15 digits wide. 
Pressing RETURN retains the current column width. 

If the values are displayed as a series of greater than symbols 
(>>>>>>), either: 

• The value is too large for the column width. If this is the case, increase 
the column width. 

• The value is an exponential number (such as IE-03) and you are in a 
fixed format. You cannot enter values in the exponential format but 
values less than .001 and greater than 9 digits to the left of the decimal 
point are automatically converted to the exponential format. 

If you do not choose a display format, the floating format is used. 

The FORMAT command does not affect how the values are stored, only 
how they are displayed in the EDIT function. The format remains in effect 
until changed or until you exit the EDIT function. 

Print—Listing a Series 

The PRINT command lets you print a copy of the current screen content 
on your printer. You are prompted for the slot number to which the printer 
is attached the first time you use the PRINT command during a session. 
The program remembers the specified slot number. 

The command prints the contents of the current screen without the 
bold bars and without any blank lines at the bottom of the screen. 

PRINT lists the contents of the currently displayed screen and then 
returns you to the entry level. 
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You can stop a printing operation by pressind CTRL-C. 

Undo—Remove All Changes 

The UNDO command cancels all the changes made to the series since 
you selected the EDIT function. If you UNDO a newly created series, it is 
completely erased. 

Keep in mind that the UNDO command removes all changes made 
since selecting the series, not just the last change. 

Edit—Returning to the Entry Level 

The EDI1 command takes you back to the entry level of the EDIT function 
without executing any of the commands. 

Fill—Adding to a Series 

The FILL command provides a means of inserting values into the middle 
of a series interpolating missing values. You can insert values in an arith¬ 
metic or geometric progression from the value at the current cursor 
location. You can also select a whole series and insert it into the series 
being edited. You can fill in missing values in a series, interpolating 
between two known values. ^\ 

The FILL command displays its own menu. 
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The ARITH and GEOMET functions both operate in the same manner. 
They prompt for a number of values to be inserted. The number can be 
any value that, when added to the existing points in the series, does not 
exceed the maximum of 150 points in a series or the 645 points in memory. 
Next the function prompts for a factor to be used in the calculation of the 
new values. In the ARITH function, the factor is added to the current 
cursor value and each generated value until the specified number of 
values have been generated. In the GEOMET function, each successive 
value is multiplied by the factor. 

The INSERT function displays the current list of series in memory. You 
can select one. It is inserted, in its entirety, into the current series at the 
cursor location. If you insert a series into itself, the inserted values are 
those that existed before entering the Edit function. 

The INTERP function performs a linear interpolation of values beginning 
at the current cursor location and continuing to the first non-zero value. 
This function fills in missing data values. The missing values must be 
entered as zeros. There can be one or more missing values. 

If the value at the cursor is not, zero, a beep is sounded and the function 
is canceled. If the value is zero, the function looks at the preceding period 
for a starting point and the next non-zero for an ending value. It then 
linearly interpolates all points in between. 

Point the cursor to the first zero value in the sequence before invoking 
the function. 

The EXIT option returns to the entry level without performing a FILL 
command. 

SOME EXERCISES WITH THE EDITOR COMMANDS 

The following exercises give you some practice using the commonly 
used Edit functions. To do these exercises you must LOAD the file 
SAMPLE 2 from the VisiTrend/VisiPlot program diskette. 

EXIT to the Main Storage Management menu, CLEAR memory, and 
LOAD the file named SAMPLE 2 which contains a series with the same 
name. You used the CLEAR function in the last lesson. It prompts you to 
decide what to keep and what to clear. This time, erase everything in 
memory by selecting the (KEEP NONE) option. Now select LOAD and 
SAMPLE 2 from the directory listing. 
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Large Series Displays 

Select EDIT and then select the series SAMPLE 2. This series has 133 
data points and a period of 12 (monthly). Its start date is 1977 1, the first 
period of 1977 or January 1977. 

The screen fills with numbers when you select the series. The date is in 
the left margin of the screen. For each date there are 12 periods; for each 
period there is a value. The dates are to the left of the vertical bar. The 
period is the first number to the right of the vertical bar. The value is to the 
right of the period. 

Moving the Cursor and Scrolling the Screen 

SAMPLE 2 contains 133 data points but the screen can only display 
20 of them at a time. To see the values beyond the first 20, move the cursor 
to the bottom of the screen with the right arrow key. Continue pressing the 
key when the cursor reaches the bottom. New dates and values appear at 
the bottom and old ones disappear off the top. This is scrolling; it is one 
means of moving to any point in the series. 

Press the left arrow key until you reach the top of the screen. Continue 
pressing the key. New values appear at the top and others disappear off 
the bottom. If you keep pressing the key until you reach the beginning of 
the series, there is a beep indicating that you can't go any further. 

Moving With the Jump Command 

If you wanted to add more values to the end of this series, you would 
have to press the right arrow key 133 times to reach the end. You can save 
time and effort by using the JUMP command. Press ESC to display the Edit 
command menu. Press RETURN with the cursor on JUMP. 

The JUMP prompt says that you can enter a date or press one of the 
arrow keys. If you specify a date, the portion of the series containing that 
date is displayed. 

Enter 1981 and press RETURN. You are asked for the period because 
this series has a period other than 1. Enter 1 and press RETURN. The data 
on the screen is erased and new data appears. The cursor appears at the 
bottom of the screen on the first period of 1981. If you specified the same 
date and period from a point below it in the series, the target date would 
appear at the top of the screen. The location of the target depends on the 
direction the cursor must move. 
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You can also use the arrow keys with the JUMP command. Press ESC 
again. Select JUMP. The right arrow key moves to the bottom of the series 
and the left arrow key to the top. Press the right arrow key. The display 
changes; the new display shows the end of the series. 

Formatting the Data 

The values in this series are displayed with different numbers of decimal 
places, to different precisions. This is the floating point data format. This 
format gives a cluttered appearance to the screen and, at times, makes 
the values difficult to read. 

With the help of the FORMAT command you can display the values in a 
manner that is neater and more readable. 


Go to the Edit command menu and select FORMAT. The top line of the 
status area indicates that the data is currently in the floating format. The 
second line tells you to enter a value of 0 through 6 to set a fixed precision. 
The number indicates the number of decimal places to which each 
number is to be displayed. It also says that you can enter —1 to specify 
floating format, which is the format in which the data is currently dis¬ 
played. The last item in the prompt says to press RETURN alone to cancel 
the command. 


Enter the number 2 to specify the fixed point format with two places of 
precision. Press RETURN. You are prompted for the column width. The 
width is the total number of digits that can be displayed in the column 
including the decimal point. This can range from 6 through 15. If you 
press RETURN without entering a value, the current column width is 
kept. For now, just press RETURN. 

The series on the screen is redisplayed with the decimal points lined up 
and two digits to the right of the decimal point. 


Printing the Data On the Screen 

If you have a printer attached to your computer, you can print the 
contents of the current screen. Press ESC and select the PRINT command. 
If you have not yet used the printer since loading the VisiTrend/VisiPlot 
program the program prompts for the slot number to which it is attached. 
If the printer is connected to slot 1, enter the number 1 and press RETURN. 


The printer begins printing the screen contents. You can let the whole 
screenful print or can stop it by pressing CTRL-C. 
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Inserting Data Into the Middle of a Series 

Display the beginning of the series and move the cursor to the first 
period of 1978. Press ESC and select the INSERT command. 

Note that the value that was in this location has moved down one place 
in the series. Also, the values that followed the value have each moved 
down one place. The dates did not change, however, one new period 
was added to the end of the series. 


You can now insert a new value at this point in the series. Type 999 
and press RETURN. The value 999 is inserted into the 1978 period 1 
location. 

To insert multiple values, press the right arrow key after typing the 
value. The value is placed in the current open space and a new space 
is opened following the new value. To terminate the insertion, press 
RETURN. Press ESC, select INSERT again and enter two more values of 
999 using the right arrow key. After you enter the second value, press 
RETURN. 


After RETURN is pressed, the editor returns to the entry level. 


Deleting Data from a Series 

If you decide you don't want the three 999 values in the series, you can 
delete them with the DELETE command. 


Move the cursor to the first 999 and call the Edit command menu by 
pressing the ESC key. Select DELETE. The status area says you are currently 
set to delete from 1978 1 to 1978 1, or one point in the series. The status 
area also says that you can press the ESC key to abort the deletion. 

Press the right arrow key several times and watch the status area each 
time you press the key. The TO date changes as the cursor moves from 
value to value. Move the cursor back to the third 999 value at 1978 3. Press 
RETURN. The display is erased and rewritten. The three 999 values are 
removed and the series is back to its original condition. 


CONTINUING WITH THE EDIT FUNCTIONS 


The remaining Edit functions should be easy to use with the experience 
you now have. If you have any problems with any of them, look them up 
in the reference section. 
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LESSON FOUR 

USING THE VISITREND™ PROGRAM 

The VisiTrend program develops ancillary data series used in analysis 
and forecasting techniques. The methods include derivation of moving 
averages, smoothed data, percent of change, leading, lagging, and 
cumulative total functions. Additionally, new series can be created by 
taking sums ratios, logs, or other mathematical or logical transformations 
on the data. The program performs linear multiple regressions (using the 
ordinary least squares method). It calculates and displays the major 
statistical measures of a multiple regression including the standard errors 
of the coefficients and the regression, T-statistic, R-Bar squared, the 
F-statistic, and the Durbin-Watson statistic. It also performs trendline 
forecasting. The program calculates and generates tables of statistical 
measures such as minimum, maximum, mean, variance, standard devia¬ 
tion, and correlation coefficient. 

NOTE: This lesson assumes you are familiar with techniques that are 
beyond the scope of this book. 

The use of DIF files lets you move data from other Personal Software 
programs, such as VisiCalc, perform any statistical function, and return 
the new data to the other program. 

BEYOND THE VISIPLOT PROGRAM 

The VisiPlot program gives you the advantage of creating a visual 
representation of data. Seeing two sets of values on a screen can be much 
more meaningful than looking at two lists of figures. The charts let you 
see relationships at a glance. The VisiPlot program gave you the capa¬ 
bility of generating scatter charts, plotting two series against each other 
to see if there is or is not a basic correlation. 

The VisiTrend program goes beyond these useful but limited visual 
measures with hard, proven mathematical techniques for forecasting, 
evaluation, and comparison. 

LOADING THE VISITREND PROGRAM 

You enter the VisiTrend program from the Storage Management 
program via the — >TREND menu item. This lesson uses the series in a file 
named SECURITIES MKT. This file is large, it contains 13 series. If you 
have any new series in memory or modified series, store them on diskette 
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with the SAVE function. Then remove all series from memory with the 
CLEAR function. When memory is empty, LOAD the file SECURITIES MKT. 

Move the cursor to >TREND and press RETURN. The long prompt 
reads GO TO VISITREND. 



The program responds with TYPE Y TO CONFIRM. Press the Y key and the 
PLEASE WAIT message is displayed. Shortly the disk drive begins to run. 
When it stops, the VisiTrend menu is displayed. 
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With three exceptions, the menu items should look familiar. You have 
used four of these menu items in the Storage Management program or the 
Plot program. You have used: 

• EDI which provides the means of entering new series data and modify¬ 
ing existing data. This function is identical to the EDIT function in the 
Storage Management program. The data entry and editing functions 
are often useful when handling VisiTrend data; the presence of this 
function saves the time that would be required to go to the Storage 
Management program and back. 

• >MAIN, which reloads the Storage Management program and 
passes control to it. This function operates exactly as its counterpart 
in the Plot program. It prompts you to verify the selection by pressing 
the Y key. 

• LOOKUP, which displays a list of all series currently in memory. This 
function operates exactly as the LOOKUP function in the Storage 
Management program. 

• CLEAR, which removes one or more to all series from memory. This 
function operates exactly as the CLEAR function in the Storage Man¬ 
agement program. 

If you are not sure about the use of these functions, review their use in 
Lessons One, Two, or Three. 

The remaining three functions contain the heart of the VisiTrend 
capabilities: 

• ANALYZE performs linear multiple regression and trendline forecast¬ 
ing, calculates the common statistical measures of series such as 
variance, standard deviation, and coefficient of correlation, generates 
tabular output, and formats the data. 

• FUNCTION generates new series that are permutations of existing 
series. It calculates the moving average, percent of change, and 
cumulative total; does exponential smoothing; and generates leading 
and lagging series. 

• XFORM provides the facilities that allow you to develop your own trans¬ 
formation of a data series. It allows the manipulation of series through 
mathematical and logical operations (see Applesoft functions). 

KEEPING TRACK OF MEMORY 

Many of the VisiTrend functions create new series. This means that 
there must be space for new series before executing those functions that 
create series. 
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All operations in FUNCTION create one new series. The multiple regres¬ 
sion function in ANALYZE creates two new series. Before beginning 
execution, use the LOOKUP function to make sure there is enough space 
for the series output by the function. If there is not enough space, you must 
make space with the CLEAR function. 

USING THE ANALYZE FUNCTION 

The ANALYZE function displays a menu of five items. Move the cursor to 
ANALYZE and press RETURN. 



There are two familiar functions in this menu. 

EXIT returns to the Main VisiTrend menu. It provides the route back 
without performing any operation. 

FORMAT lets you specify how the data will be displayed. This function 
works exactly like the FORMAT function in the EDIT commands menu. It 
lets you specify fixed point or floating point formats, the number of places 
of precision (0-6) in the fixed point format, and the total number of spaces 
in which values are displayed (6-15). 

The remaining items, TABLE, STATS, and REGRESS, are described in the 
following sections. 
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Listing Series In Table Format 

The TABLE function displays one or more series, up to the number that 
can be displayed on the 40 column screen. This function lines the values 
up by date for easy comparison and evaluation. 

Because there is a limited space for the display of data, the function 
ignores series for which it has no room. The number that can be displayed 
depends on the column size specified in the FORMAT function. The pro¬ 
gram uses a column width of nine characters and the floating point format. 

Move the cursor to TABLE and press RETURN. The familiar listing of 
series in memory appears. 



You can select a single series by moving the cursor to the name and 
pressing RETURN. To select two or more series, move the cursor to each 
name in turn and press the space bar. As you have seen before, pressing 
the space bar marks a name with an asterisk (*), indicating that the series 
is selected. You can remove the asterisk (and unselect the item) by press¬ 
ing the space bar a second time. 

The (ALL) item selects all items on the list. Unless the list is small, not all 
series can be displayed. The (NONE) item is a means of exiting the 
function without displaying a table. 


Move the cursor to XY EARNINGS and press the space bar. Do the same 


with XY DIVIDENDS and XY BOOK VALUE. With all three marked with an 
asterisk and the cursor on the XY BOOK VALUE press the RETURN key. 
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The program lists the union of the ranges of the selected series in the 
top line of the status area. You are asked to specify whether you want to 
KEEP that range or CHANGE it. If you decide to CHANGE it, you will be 
prompted for a beginning and ending date and, if applicable, periods. 
For this example, press RETURN with the cursor on KEEP. 

The date is displayed down the left margin of the screen. The series are 
displayed in the order in which you selected them. The column headings 
in the bottom line of the status area are shortened to the seven character 
column width. Longer names are always truncated unless the column 
width is large enough for the whole name. 



The status area gives you the option of continuing or printing the table. 
If you select CONTINUE, the table is erased and you are returned to the 
Main VisiTrend menu. If you select PRINT, the amount of the table cur¬ 
rently on the screen is printed on your printer. If you are using the printer 
for the first time during this VisiTrend/VisiPlot session, you are prompted 
to enter the slot number for the printer control card. 

A maximum of 19 periods can be displayed on the screen. If the series 
contains more than 19 periods, the first 19 are displayed and the remainder 
are displayed, 19 at a time, when you select CONTINUE. If you want to 
print a screen of data, you must do it while it is displayed. You can exit 
from the TABLE function before displaying all points by selecting EXIT. EXIT 
is not an option if the whole series fits on a single screen. In this case, 
CONTINUE exits from the function. 
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Calculating Series Statistics 


The STATS function displays a table of common descriptive statistical 
measurements. The table includes the count of the number of items used 
for the calculations, the minimum and maximum value in each series, the 
arithemetic mean (average), the variance, and the standard deviation. 
If more than one series is selected, it also calculates the coefficients of 
correlation between all combinations of selected series. 


Move the cursor to ANALYZE and press RETURN. Then move the cursor 
to STATS and press RETURN. The function displays the list of series just as 
TABLE did. Select XY EARNINGS, XY DIVIDENDS, and XY BOOK VALUE with 
the space bar just as you did for TABLE. Now press RETURN. 

The range is displayed and you have the option of keeping this range 
or changing it. The range used by the STATS function is the intersection of 
the ranges of the selected series, not the union of ranges as the TABLE 
function used. Press RETURN with the cursor on KEEP. 


The message COMPUTING. . is displayed in the status area. When the 
computations are complete, the calculated values are displayed in 
columns with the series name at the top. The meaning of each value is 
listed in the left hand column. The range that the data covers is listed at 
the bottom of the table. 



You have the option of printing the statistics or continuing. If you do not 
print them, you will have to rerun the function to obtain them again. 
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With the cursor on CONTINUE press RETURN. The COMPUTING... 
message appears again. The function is calculating the coefficients of 
correlation between the three selected series. When the computation is 
complete, they are displayed in a matrix as shown in the photograph. 



Again you have the choice of printing the coefficients or continuing. 
Press RETURN with the cursor on CONTINUE. You are returned to the 
Main VisiTrend menu. 


Performing A Linear Multiple Regression 

The final option on the ANALYZE menu is REGRESS, which does a linear 
multiple regression (least squares). Multiple regression is a method of 
developing a formula that relates a single variable (called the dependent 
variable) to one to five other variables (called the independent variables). 
The resulting equation should explain the dependent variable in terms of 
the independent variables and a constant. 

The VisiTrend/VisiPlot REGRESS function accepts a maximum of five 
independent variables. The function requires, as a minimum, as many 
data points as there are independent variables. 


There are many common uses of this technique. It is used to forecast 
the output of one industry on the basis of the output of another industry. 
For example, we should be able to assume that the steel industry follows 
the performance of the auto industry. It is used to forecast the performance 
of a stock in terms of the measures of the economy. 
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The technique develops a constant (K) and coefficients (C n ) for each 
independent variable (V^)) such that a point in the dependent variable 
(D(i)) is approximated from the corresponding period data in the inde¬ 
pendent variables according to the formula: 

D (i) =K + CiVi (i) =C 2 V2 (i )=C n V n(i) 

NOTE: You can do exponential and other types of regressions by using 
the XFORM function to convert series to a form acceptable for a linear 
multiple regression. 

REGRESS also calculates and displays the following statistical measures 
of a linear multiple regression. These include the T-statistic, the R-Bar 
Squared statistic, the corrected R-Bar Squared statistic, the Standard 
Error for the regression and for the coefficients, the sum of the squared 
residuals, the F-statistic, and the Durbin-Watson statistic. 

The REGRESS function generates two new series. The first is a fitted 
series developed from the generated constant and coefficients. The second 
is a series of the differences (residuals) between the actual dependent 
series values and the fitted values. The new series have the same name 
as the dependent series with a qualifier appended to the name. The 
qualifiers are listed in the following table. 


Qualifier 

Purpose 

Comments 

.Fn 

.Rn 

Fitted series 
Residual series 

n is a program generated number, 
n is the same for the fitted and resid¬ 
ual series from a single regression. 


Move the cursor to ANALYZE and press RETURN and then to REGRESS 
and press RETURN. 

The list of series in memory is again displayed. The status area directs 
you to select a dependent variable. For this example move the cursor to 
XY PE RATIO and press RETURN. This example tests to see if the price/ 
earnings ratio can be explained by the earnings, dividends, and book 
value. Move the cursor to XY PE RATIO and press RETURN. 

The list is erased and immediately redisplayed. This time the status 
area instructs you to select the independent variables. You can select 
from one to five series as independent variables. The independent 
variables must have the same period as the dependent variable. Move the 
cursor to XY EARNINGS and press the space bar. Do the same for XY 
DIVIDENDS and XY BOOK VALUE. Now press RETURN. 
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The intersection of the ranges of the dependent and independent 
variables is displayed in the top status area line. You have the option of 
using this range or changing it. There must be at least as many points in 
the range as there are independent variables. For example, if you select 
four independent variables, there must be four data points in the inter¬ 
section of the ranges of the dependent and independent variables. Press 
RETURN with the cursor on KEEP. 

You now have the option of generating the regress with or without a 
constant. Select CONSTANT. 

The COMPUTING. . message is displayed in the status area. It can take 
anywhere from 15 to 60 seconds or more to do the regression. The time 
increases as the number of data points and number of series increases. 
When the computation is nearing completion, the regression analysis 
is displayed as shown in the photograph. 



The Durbin-Watson statistic (DW) is the last item calculated. If there is 
not enough room for the fitted and residual series, they are not created 
and the Durbin-Watson statistic is not calculated. The message NO 
ROOM FOR REGRESSION VALUES is placed in the status area. 

You have the option of printing the regression analysis. If you choose 
not to print it, the data is lost. You must run the regression again if you 
want the data at a later time. For this example, select CONTINUE to pro¬ 
ceed without printing. 
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Next you are asked if you want to save the series containing the fitted 
and residual values. If you select NO, the series are discarded and you 
must do the regression again if you want them at a later time. Select YES to 
save the series. 


The REGRESS function exits to the Main VisiTrend menu. 

Move the cursor to LOOKUP and press RETURN. Note that the bottom 
two items on the LOOKUP list are XY PE RATI.Fn and XY PE RATI. Rn. The 

number on the end is program supplied; it will be the same for both series. 

To see the newly created values, select ANALYZE and TABLE. Select XY 
PE RATIO, XY PE RATI.Fn, and XY PE RATI.Rn. The values are displayed with 
their date. Note that the long similar series names are abbreviated to the 
same name: XY PE RA. With long names and narrow column widths you 
must sometimes remember the order in which you selected the series. 

The following photograph shows a VisiPlot line chart of the actual 
dependent data and the fitted data plotted together. 



Trend Forecasting With the Regress Function 

The REGRESS function also does trend forecasting. It calculates the 
best straight line fit for the dependent variable. You are prompted for the 
number of periods to forecast. The fitted straight line is extended for the 
specified number of periods. 
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The function generates the same displays and series that are generated 
in the multiple regression: the regression analysis, the fitted series, and 
the residual series. 

Before beginning this function, select the CLEAR function. Remove the 
previous fitted and residual series. Move the cursor to the names and 
press the space bar and then press RETURN. You must have at least two 
free series in memory to complete the REGRESS function. If there is not 
enough room for the two generated series, the message NO ROOM FOR 
REGRESSION VALUES! is issued and the functions ends before calculation 
of the Durbin-Watson statistic. 

To generate a five period forecast of the XY PE RATIO series, select 
ANALYZE, REGRESS, and XY PE RATIO. When the prompt to select the 
independent variables is displayed, the bottom item in the list is (TREND). 
Move the cursor to (TREND) and press RETURN. You cannot include any 
series as independent variables when doing a trend forecast. 

Next you are prompted to specify a number of periods to forecast. Enter 
5 and press RETURN. When the range prompt is displayed, select KEEP 
to use the range of the dependent variable. 

The status area contains the COMPUTING, message and after several 
seconds, the regression analysis display begins. 

You can CONTINUE or PRINT the analysis. Finally, you are asked if you 
want to save or discard the fitted and residual values. If you save the 
series and plot the fitted series with the actual series, you will get the 
following chart. 
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USING FUNCTION 

The items in the FUNCTION menu each generate a new series. Before 
selecting FUNCTION, make sure there is at least one free series. You will 
get the NO MORE ROOM! error message if there are no free series. 

Each function generates a new series that has the name of the source 
series with a qualifier added to the end of the name. The qualifiers for 
each function are: 


FUNCTION 

QUALIFIER 

COMMENT 

Moving Average 

Mn 

n = number of periods averaged 

Smoothing 

S 


Percent Change 

.% 


Lag 

. —n 

n = number of periods lagged 

Lead 

.+n 

n = number of periods leading 

Total 

.T 



The FUNCTION menu items all operate in a similar manner. After 
selecting the function, you are prompted to select the source series from 
the series in memory. Some functions require no further input while 
others prompt for an additional factor. This lesson contains a sample use 
of the moving average function after each function is described. 


2-79 







VISITREND M +VISIPLOT™ jgg? 

LESSON FOUR 


APPLE II 

TUTORIAL 


Moving Average 

The MOVE AVG function calculates the moving average of the source 
function for a specified number of periods. There are three common 
methods of calculating the moving average: 

• The N+l method (used in the VisiTrend program) which locates the 
first point of the moving average series one point beyond the number 
of periods being averaged as shown in the drawing. 



SOURCE 


MOVING AVERAGE 
OVER 3 PERIODS 


003-003 


• The N method which locates the first point of the moving average 
series at the last point of the periods being averaged as shown in the 
drawing. 


1971 | 1972 | 1973 | 1974 | 1975 | 



003-004 
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• The Centered method which locates the first point of the moving 
average series at the center of the periods being averaged as shown 
in the drawing. 


1970 

1971 

| 1972 | 1973 | 1974 | 1975 | 

a 

b 

G 

d 

e 

( 


[ 
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a+b+c 

b+c+d 

c+d+e 

d+e+f 

3 

3 

3 
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MOVING AVERAGE (CENTERED METHOD) 


003-005 


The moving average is essentially a smoothing technique. A common 
use of this function is to remove the noise or seasonal factors from monthly 
or quarterly data. For example, if you have monthly sales data for several 
years and want to see the trends without the month to month fluctuations, 
you can generate a moving average over a 12 month period. For quarterly 
data that contains seasonal noise, you would generate a moving average 
over a four quarter period. 

You are prompted for the number of periods. 

Smoothing 

The SMOOTH function performs a single exponential smoothing of the 
source series. The forcast generated by this technique is based on the 
most current data point and current forecast. 

You are prompted for a smoothing factor (a) which must be greater 
than 0 and less than 1. The smoothed series is calculated with the formula: 


Y(i )-a X (i .,)+ (l-a)Y (i . 1 ) 


where X(i) are points in the new series, Y(i) are points in the source series, 
and n is the smoothing factor. A high factor gives greater weight to the 
more current point, and a low factor, to the earlier point. The generated 
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series lags the source series by one period as shown in the figure. This 
lag is a one period forecast for the data in the source series. 














SMOOTHING 


003-006 


Percent of Change 

The % CHANGE function calculates the percent of change between 
date n and n+1 and puts the value at date n+1 in the new series. This 
function lets you evaluate the change in related values rather than trying 
to compare divergent magnitudes in the original values. For example, 
you may generate percent of change series for sales and cost-of-selling 
data. The original data may look like there is a low correlation when in 
fact the percent of change shows a positive cause and effect relationship. 

Lag 

The LAG function shifts the values in the source series a specified num¬ 
ber of periods to the future in the new series. A common usage of this 
technique is to align data in time in a meaningful fashion. For example, 
if you spend X dollars on advertising in January the effect of the expendi¬ 
ture will be seen in February sales. The LAG function shifts the advertising 
expenditures in time where they can be evaluated against the sales they 
prompted, that is: 

Sales(n) = {(Advertising expenditure(n—1)) 
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You are prompted to specify the number of periods to be lagged. The 
new series begins the specified number of periods later than the source 
series. The new period ends on the same date as the source period. Data 
points shifted beyond the end date are lost to the new series. The follow¬ 
ing figure shows the effect of a three period lag on a series. 


1970 1971 1972 1973 1974 



003-001 


Lead 


The LEAD function shifts the values in the source series a specified num¬ 
ber of periods to the past in the new series. This function is the reverse of 
the LAG function. In the preceding example, it would allow you to shift 
the sales data back to the expenditure of advertising dollar for evaluation. 


You are prompted to specify the number of periods. The new series 
begins on the same date as the source series. The new series ends the 
specified number of periods before the source series. Data points shifted 
beyond the beginning date are lost to the new series. The following 
figure shows the effect of a three period lead on a series. 


1970 1971 1972 1973 1974 



SOURCE 


LEAD BY 1 PERIOD 


003-002 


Totaling a Series 

The TOTAL function calculates the running total of the points in the 
source series. A given point in the new series is the total of all preceding 
points in the source series. The most common usage of this function is to 
generate year-to-date totals of monthly or quarterly data. 
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FUNCTION EXAMPLE 

This is an example of the use of the MOVE AVG function. Before start¬ 
ing, move the cursor to LOOKUP and press RETURN. There must be at 
least one free series in memory. If you already have 16 series in memory, 
remove one with the CLEAR function. 

After assuring there is room for a new series, move the cursor to 
FUNCTION and press RETURN. The FUNCTION menu is displayed. 



The first item (under the cursor) is MOVE AVG. With the cursor on this 
item, press RETURN. You are prompted to select a series on which to 
calculate the moving average. Move the cursor to XY DIVIDENDS and 
press RETURN. Next you are asked to enter the number of periods over 
which the average is to be calculated. Enter 3 and press RETURN. 

The status area reads PLEASE WAIT while the new series is being 
calculated. When the function is complete, you are returned to the Main 
VisiTrend menu. 

Move the cursor to ANALYZE and press RETURN and then to TABLE and 
press RETURN. Move the cursor to XY DIVIDENDS and press the space bar. 
Then move the cursor to the new series at the end of the list with the name 
XY DIVIDEN M3 and press the space bar. Now press RETURN. When 
prompted about the range, select KEEP. 
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The following photograph shows the table of the two series. 



Note that the series names are truncated to fit the column size. When 
you have long names you have to remember the order in which you 
selected the series; they are listed in the selected order. 


HOW TO CONVERT AN N+l MOVING AVERAGE 

You can convert the VisiTrend N+l moving average to an N or 
Centered moving average. 


Converting to an N Moving Average 

To create to an N moving average, first perform the N + l moving 
average for the desired number of periods. You must then move the Mn 
moving average back in time by one period. Then invoke the EDIT function 
and select the moving average series. Press ESC to display the Edit 
Command menu. Select SPECS from the menu and then select START from 
the Specs menu. When prompted for the new start date, specify a date 
one period earlier than the current start date. For example, if the start 
date is 1966, change it to 1965. If the start date is 1966, period 4, change 
it to 1966, period 3. 


You can also shift the N+l moving average series with the LEAD 
function. The only disadvantage to this is the loss of one period off the 
front of the modified series (see the description of the LEAD function). 
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Converting to a Centered Moving Average (odd period) 

To convert to a Centered moving average is more complicated in some 
circumstances. The complexity depends on the number of periods being 
averaged. If the average is over an odd number of periods, the moving 
average must be moved back to the middle of the number of periods 
being averaged. The N-h 1 moving average series must be moved back¬ 
ward (n-fl)/2 periods, where n is the number of periods being averaged. 

Converting to a Centered Moving Average (even period) 

When the number of periods being averaged is even, the conversion to 
a Centered moving average is more complex. Follow this procedure: 

1. Perform the N+1 moving average. 

2. Move the new series backward in time by (n/2) +1 periods, where n is 
the number of periods being averaged. 

3. Perform another N+l moving average on the series resulting from 
step 2. 

4. Move the series resulting from step 3 backward in time by 1 period. 

WRITING YOUR OWN SERIES TRANSFORMATION 

While the FUNCTION and ANALYZE options offer a large set of series 
data manipulation functions, they cannot meet all your needs. This 
function allows such operations as the conversion of exponential values 
to first order values for inclusion in a linear multiple regression. For 
example, if you think that there may be a meaningful correlation such 
that: 

Y = f(x 2 ) 

You can transform the x 2 values to first order values with the XFORM 
formula EXP(x 2 ) which gives a value that is valid for the VisiTrend 
REGRESS function. 

The XFORM function lets you write your own transformation formula. 
The formulas are limited to two lines (80 characters). You have the use of 
the following mathematical, logical, and comparative operators in 
writing your transformation formula: 

• Mathematical operators-h (addition), — (subtraction), * (multiplica¬ 

tion), / (division), and A (exponention). 

• Logical operators—AND, OR, and NOT. 

• Comparative operators—< (less than), <= (less than or equal), 
= (equal), > (greater than), and > = (greater than or equal). 
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You can use parentheses to control the execution order of the formula. 
All operations in parentheses are performed before the operations out¬ 
side the parentheses. All parentheses must be balanced or an error will 
occur. 

In addition to the mathematical, logical, and comparative operators, 
you have the following Applesoft functions: 

• SGN—Sign 

• INT—Integer part of 

• SQR—Square root 

• LOG—Natural logarithm 

• EXP—e to the power of 

• RND—Random number between 0 and 1 

• ABS—Absolute value of 

• SIN—Sine 

• COS—Cosine 

• TAN—Tangent 

• ATN—Arctangent 

The Applesoft functions are used just as they are used in a Basic pro¬ 
gram. The only difference here is that you can use a series as the variable 
on which the function operates. In this case the function is performed on 
each data point in the series. For example, SQR(XY EARNINGS) gener¬ 
ates a series with the same beginning and ending dates and period. Each 
data point in the new series is the square root of the corresponding data 
point in XY EARNINGS. 

You can include series names in your transformation formula. The 
function displays the list of series currently in memory. You select a 
series by pressing the right arrow key which moves the cursor into the list 
of series. Then you move the cursor to the desired series and press 
RETURN. Do not type the name of a series; an error results if you type the 
series name into the formula. 

The following example creates a new series with the name BD AVG. 
The series is the average of the daily high and low stock prices contained 
in the series DB HIGH and DB LOW. 

Before beginning the example, use the LOOKUP function and make 
sure there is a free series space in memory. 

Move the cursor to XFORK/1 and press RETURN. The function prompts 
for a name for the series that will hold the transformed data. Enter DB 
AVG and press RETURN. 
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A list of the series in- memory is displayed. The top line of the status 
area reads ENTER TRANSFORM, — > OR RETURN. This means that you 
can enter any transform operator or function from the keyboard, enter a 
series name by activating the cursor with the right arrow key, or press 
the RETURN key to indicate that the formula is complete. The transform 
formula uses all of these. 



When you want to erase part of a formula you have entered, press the 
ESC key. If a series name is in the formula when the ESC key is pressed, it 
is bracketed by slashes for easier reading. If you press ESC to correct a 
series name, the whole name is erased with a single press of the key. You 
do not have to erase each letter of the name. 

Enter a left parenthesis. Next press the right arrow key. A cursor 
appears in the series list. Also the name at the cursor appears in the 
formula line in the status area. Press the right arrow key again and the 
cursor moves down and the name in the status area changes. Move the 
cursor to BD HIGH and press RETURN. The cursor disappears from the list 
and BD HIGH remains in the formula. 


Enter the plus sign ( + )• Again press the right arrow key. Again a cursor 
appears and a series name is written in the status area. This time move 
the cursor to BD LOW and press RETURN. 


Enter a right parenthesis, slash (for division) and 2. You now have a 
formula in the status area that reads: 


(BD HIGH + BD LOW )/2 
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To generate a new series from this formula, press the RETURN key. If 
the last item in the formula had been a series name, you would have had 
to press the RETURN key twice, once to enter the series name and once 
to execute the formula. 

The PLEASE WAIT message is displayed while the new series is being 
generated. 

When the function is finished, the Main VisiTrend menu is displayed. 
Move the cursor to LOOKUP and press RETURN. The list shows that the 
function created a new series with the name BD AVG. The following 
photograph shows the new series plotted as a line, overlaying a HI-LO 
chart of BD HIGH and BD LOW. 



CONTINUING WITH THE VISITREND PROGRAM 


You should be able to go back to the functions you have used in this 
lesson and do analysis work on your data. You should be able to use the 
FUNCTION items that you have not used. Finally, you should be able to 
SAVE your VisiTrend output on the data diskette and be able to plot the 
data with the Plot program. 

If you are not sure of the use of the VisiTrend functions, review this 
lesson. For a review of the Plot program see Lesson One, for the Storage 
Management program see Lesson Two and for the Edit functions see 
Lesson Three. 


For a quick and direct explanation of the functions in all three pro¬ 
grams, see the Reference section. 
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MORE ABOUT PLOTTING 

This lesson is a series of step by step examples showing how to make 
different kinds of VisiTrend/VisiPlot charts. The data series that are used 
in these examples are stored on the VisiTrend/VisiPlot program diskette 
under the names GEM PRICES, PRESPREF, and MATH FUNCTIONS. 

The GEM PRICES file contains series of the prices of 1 and 2 carat 
rubies for the years 1974 through 1980, the price of 3 carat sapphires over 
the same period, the price of a 1 carat investment quality diamond for 
the years 1967 through 1978, and the Consumer Price Index for the years 
1967 through 1978. 

The PRESPREF file contains series of political poll data taken at ran¬ 
dom times during a mythical election campaign. 

The MATH FUNCTIONS file contains two series of values for two 
math functions. 

This lesson assumes you have read and used the functions described 
in Lesson One and Lesson Two covering the Plot and Storage Manage¬ 
ment programs. 

GETTING STARTED 

Load the VisiTrend/VisiPlot program and then LOAD the GEM PRICES, 
PRESPREF, and MATH FUNCTIONS files from the program diskette. Call 
the Plot program. If you have trouble with any of these operations, review 
Lesson Two. 

This lesson shows how to generate many different charts and how to 
combine charts. The sections begin with a picture of the chart that is to 
be generated. The picture is followed by a list of the keys you must press 
to generate the chart. A key name preceded by a word or phrase enclosed 
within parentheses indicates a cursor position you must make before 
pressing the indicated key. A word or phrase in quotation marks preceded 
by the word Enter indicates that the word or phrase must be typed. For 
example: 

• SPACE BAR—means press the space bar. 

• RETURN—means press the RETURN key. 

• (LINE) RETURN—means move the cursor to LINE and press the 
RETURN key. 



APPLE II 

TUTORIAL 


VISITREND M +VISIPLOT™ gggj? 

LESSON FIVE 


• Enter "PERCENT OR TOTAL" RETURN—means enter the phrase 
at the keyboard and press the RETURN key. 


SINGLE LINE CHART 



Beginning in the Select menu: 
(LINE) RETURN 


(1C RUBY) RETURN 
(PLOT) RETURN 

There is nothing new in this chart except the data. You generated 
several single line charts like this one in Lesson One. 
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TWO LINE CHART 



(NEW) RETURN 

■'"N 

(LINE) RETURN 
(1C RUBY) SPACE BAR 


(3C SAPPHIRE) RETURN 
(PLOT) RETURN 

There are a couple of new things in this chart. First the chart contains 
two lines instead of one. The two lines are plotted with different symbols— 
the square box which you saw in Lesson One and a diamond shaped sym¬ 
bol. The legend at the bottom of the chart lists both series and shows what 
plotting symbol was used for each. The bottom line of the status area lists 
the last series selected and now contains an ellipsis following the type of 
chart. The Ellipsis indicates that multiple series were selected. 

Note that both series were selected before the plot was drawn. 
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(NEW) RETURN 
(LINE) RETURN 
(1C RUBY) SPACE BAR 
(2C RUBY) SPACE BAR 
(3C SAPPHIRE) RETURN 
(PLOT) RETURN 

The new feature of this chart is the use of the pound sign (#) as the plot¬ 
ting symbol of the third series. Note that the Y-axis scale has a factor of 
10E3 (or 1000) at the top, indicating that Y-axis labels must be multiplied 
by 1000. 

This chart is difficult to read. The information for the years 1974 through 
1979 is crammed together in a small space. The only thing that shows up 
well is the 1980 price of 2 carat rubies. This chart may be satisfactory if 
its purpose is to show what happened to the price of 2 carat rubies in 1980. 
However, if the other information is equally important, it might be a good 
idea to change the range to 1974 through 1979 and handle the 1980, 2 
carat ruby price in some other manner. 
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Another approach is to change the scale to show the earlier data 
clearly and let 1980, 2 carat ruby price go off the chart and show its value 
with a moveable title. This is the approach used in the following photo¬ 
graph. 



SINGLE BAR CHART 



(NEW) RETURN 
(BAR) RETURN 
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(NORMAL) RETURN 
(1C RUBY) RETURN 
(PLOT) RETURN 

Again, this chart is no different than the bar charts you did in Lesson 
One. It can be made different by selecting half-width bars. Repeat the 
sequence and select LEFT instead of NORMAL when the Bar menu is 
displayed. 



The only differences in the chart are the width of the bars and the bottom 
line of the status area which says BAR-LEFT where it said BAR on the chart 
with full-width bars. 

The half-width bars are used for comparative charts as shown in the 
next example. 
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COMPARATIVE BAR CHART 



(NEW) RETURN 
(BAR) RETURN 
(LEFT) RETURN 
(1C RUBY) RETURN 
(PLOT) RETURN 
(SELECT) RETURN 
(BAR) RETURN 
(RIGHT) RETURN 
(3C SAPPHIRE) RETURN 
(OPTIONS) RETURN 
(COLOR) RETURN 
(GREEN) RETURN 
(OVERLAY) RETURN 
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There are many differences in the appearance of this chart and in the 
making of it. First, instead of choosing both series and plotting them as 
was done with multiple line charts, you selected each series on a separate 
pass through the Select menu. If you had chosen the two series at the 
same time (as you did for the two line chart), you would get a different 
chart. When the series are chosen on the same pass through the Select 
menu, the chart shows the series stacked on top of each other as shown 
in the following photograph. 



Generating the chart in this way, the two values are added. You will 
use this style of bar chart when you are interested in the sum of the two 
series. 

To add the second series to the first chart, you used the OVERLAY 
function rather than the PLOT function. OVERLAY draws the new chart on 
top of the existing chart. It uses the same range and scale as the existing 
chart. 


You also changed the color of the second set of bars. If you had not, 
both sets of bars would have been the same color and wouldn't have shown 
up as clearly. Instead of changing the color you could have changed 
the format of the second bars to outlined or shaded. 


Overlaying a chart does not put a legend at the bottom. You must add 
that yourself with the TITLE options. You should put in the names of both 
series and specify which is which as shown in the following picture. 
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Note that the horizontal grid lines make the values at the right side of 
the chart easier to read. 

You may see a slight overlay between the bars in a comparative bar 
chart. You may also see a slight offset between the upper and lower bars 
a stacked bar chart. Both of these conditions are caused by the Apple II 
color techniques. 

THE PIE CHART DATA 

In the following sections you are going to draw pie charts. The data is 
from the file named PRESPREF that you loaded at the beginning of this 
lesson. The charts use four series, the ones named BROWN, GREEN, WHITE, 
and UNDECIDED. Each series has two data points. The first data point in 
each series represents the percent preference for each candidate in a 2- 
way Brown-Green race (the White value is 0). The second data point in 
each series represents the percent preference in a 3-way race of all 
candidates. 

The data used in pie charts does not have to represent a time series. The 
value of the zero data point represents one set of circumstances and the 
value of the 1st data point represents another. In this case the dates 
represent data items that are not necessarily related by time. 

A pie chart shows a single point in time and not a comparison of differ¬ 
ent points in time as our other charts have. The VisiTrend/VisiPlot program 
requires that the different values used in pie charts be from different _ 
series. All the values must be at the same date or reference number. The 
plotting fails if any of the series do not have the specified date. 
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A PIE CHART 



(NEW) RETURN 
(PIE) RETURN 
(BROWN) SPACE BAR 
(GREEN) SPACE BAR 

(UNDECIDED) RETURN 
Enter "0" RETURN 


Note that the WHITE series was not included. It wasn't needed because 
point 0 has a value of 0. If you had included the WHITE series, it would 
have been listed in the legend with a zero percentage and would have a 
segment of the pie. 

Each segment of the pie is labeled with a letter. The letter refers to the 
items in the legend. This order of the series around the pie and in the 
legend is significant, it is the order in which you selected them. If you 
had selected them in the opposite order, they would be listed in the 
opposite order and would have different relative positions on the pie. The 
first series always begins at the 3 o'clock position and extends in a clock¬ 
wise direction. 


The bottom line of the legend contains a zero. This is the date or refer¬ 
ence number of the selected data. 
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Shading and Titling a Pie Chart 

The generation of a pie chart follows a fixed series of events. After 
drawing the chart you are sent directly to the Title menu. Following the 
Title menu, you are given a chance to shade the chart. Then you have 
another chance at the Title menu. There are two passes at the Title menu 
because it is possible to cover a title with shading. When you exit the 
Title menu the second time, you have finished. There is no way back to 
the Title or shading functions. If you made a mistake, you must start over 
from the beginning. 

When the chart is finished, you have a screen with the picture and 
legend. Press RETURN and the Title menu appears. For now, press EXIT 
and proceed to the Shading function. 

The Shading function asks you to enter a letter or RETURN. It is asking 
for a letter indicating a segment of the pie. You can specify the labels in 
any order; you can skip any you don't want shaded. If you change your 
mind, you can change the color of a segment you have already shaded. 

Enter A and press RETURN. The Color menu is displayed. If you have 
a color display unit, you can choose any color. If you have a black and 
white display unit, you should limit your selections to black, white, and 
one other color. All other colors look the same in black and white. For 
now, select WHITE and press RETURN. Segment A is filled in. 

You are asked for another letter. Enter B and press RETURN. This time 
select GREEN and press RETURN. The B segment is filled in. Leave the C 
segment as it is—black. Press RETURN. You are asked to confirm that 
you want to leave the shading function. This confirmation is necessary 
because you have only one chance to shade the chart. Once you leave 
this function you cannot get back to it without starting the chart over from 
scratch. 

Enter Y and the Title menu reappears. 

With one exception to be covered later, the Title functions operate 
exactly as they did when you titled a chart in Lesson One. Use that 
experience and put in the titles to make the chart look like the following 
picture. 


2-100 



APPLE II 

TUTORIAL 


VISITREND™+ VISIPLOT™ iS 5 

LESSON FIVE 



The legend doesn't add much to the chart with all of the legend infor¬ 
mation on the chart itself. With a pie chart, the LEGEND function erases 
the legend. Whereas the LEGEND function returned the legend in other 
charts, it erases the legend in pie charts. Select LEGEND and press 
RETURN. You should remove the legend before locating titles anywhere 
to the right of the left side of the legend. That entire side of the screen is 
erased to eliminate the legend. 

To try your hand at another pie chart, use the 6ame three series plus 
the WHITE series and use data point 1. 

DISPLAYING TWO CHARTS AT ONCE 

The same data you used for the pie charts is also available in a different 
form in the series 2 MAN RACE and 3 MAN RACE. All the 0 points are in 
2 MAN RACE and the 1 points are in 3MAN RACE. It is often desirable to 
show the different forms of data at the same time, in two different charts. 

The WINDOW function in the Main Plot menu provides this capability. 
It divides the screen into two parts. You can draw different charts in each 
window. You can put any kind of chart into the windows except the pie 
chart. A pie chart requires the whole screen. 

The WINDOW menu gives you the choice of dividing the screen into 
side by side or top and bottom sections. This example uses top and bottom 
sections. The WINDOW menu also lets you switch between the windows 
and provides a means to return to single window operation. 
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When you enter the Window function, the active window is the top one 
if you chose HORIZ windows and the left window if you chose VERT 
windows. 

When you switch between windows, you lose the current active series 
and option data for the window you are leaving. When you return to the 
window, you must start over if you want to change an option and rePLOT 
the chart. 



The following series of commands assumes that you are beginning from 
the Select menu. 

(NONE) RETURN 

(WINDOW) RETURN 

(HORIZ) RETURN 

(BAR) RETURN 

(NORMAL) RETURN 

(2 MAN RACE) RETURN 

(PLOT) RETURN 

RETURN 

(WINDOW) RETURN 
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you must enter the RUN INIT command. The VisiTrend/VisiPlot program 
is reloaded. Any series in memory are lost when you verity that you want 
to execute the QUIT function. 


RANGE (Plot program—Options menu) 

The RANGE function calls the Range menu. The Range menu displays 
the current series range. The Range menu lets you SE a new range or 
CLEAR a range you have previously SET. When SET is chosen, it prompts 
for new starting and ending dates. The chart is not redrawn until the 1QT 
function is executed. You also have the option to xAR a user-set range. 
CLEAR has no effect on the range if you have not changed it with the SET 
option. You also have the option of exiting the function. 

See the description of range for a description of how the VisiTrend/ 
VisiPlot program set ranges for different chart types. 


REGRESS (VisiTrend program—Analyze menu) 

The Rt ( -RESS function performs an ordinary least squares multiple 
regression. You are prompted to specify the dependent variable and from 
one to five independent variables from the list of series currently in mem¬ 
ory. If you select more than five series for independent variables, an error 
message is issued. You are asked if you want to keep or change the 
current range for the selections. In a regression, the current range is the 
logical intersection of the ranges of the dependent and independent 
variables. The intersection of the ranges must have at least as many points 
as there are independent variables. Finally, you are prompted to choose 
whether the regression is to be computed with a constant term or through 
the origin (no constant). 


The A GES function, optionally, generates a forecast series. This 
option is chosen by selecting the item (TREND as the independent vari¬ 
able. You are asked to specify the number of periods to be forecast. The 
function develops a straight line series based on the dependent variable. 
It then extends the series the specified number of periods. 


The regression computation typically takes 15 to 60 seconds. The results 
are displayed on the screen. These include the name of the dependent 
variable, the range, and the number of data points. For each independent 
variable, the series name, coefficient, standard error, and T-statistic are 
displayed. Below this information, the regression statistics are displayed, 
these are the R-squared, the corrected R-squared, the standard error of 
the regression, the sum of the squared residuals, the F-test value of the 
regression, and the Durbin-Watson statistic. When you perform a regres¬ 
sion on one independent variable with no constant, the F-statistic and the 
corrected R-squared are meaningless and, therefore, are not computed. 
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After the results of the computations are displayed, you have the option 
of printing the display on a printer. If you do not print them, they are lost. 

If there are at least two free series in memory and enough free data 
points in which to store the fitted values and residuals, you are prompted 
to choose to keep or discard these generated series. If you keep the values, 
they are saved under the name of the dependent variable with ".Fn" 
appended to the fitted series and ".Rn" appended to the residual series, 
n is a program generated number. 

RESCALE (Plot program—Options menu) 

The RESCALE function changes the Y-axis scale established by the 
program. The function prompts for a new minimum and a new maximum 
value. It also requests the number of divisions into which the Y-axis is to 
be divided (tick marks). For a scatter chart, it also prompts for maximum, 
minimum, and number of divisions for the X-axis. 

If you specify a minimum that is greater than the maximum, the program 
reverses the values. If you specify the same value for the minimum and 
maximum, the program uses the specified value as the minimum and sets 
a maximum that is approximately 20 percent higher. 

See the Scale section for a description of how the program sets scales 
for the charts. 

RIGHT (Plot program—Bar menu) 

The RIGHT function specifies that a bar chart is to be drawn with half- 
width bars located to the right of the tick marks. This function, along with 
the LEFT function, is used to draw comparative bar charts. 

SAVE (Storage Management program—Main menu) 

The SAVE function writes one or more series to a diskette file for perma¬ 
nent storage. You must choose whether the data is to be saved in the 
normal VisiTrend/VisiPlot format or the DIF format. After you select a 
format, the function displays a list of the series currently in memory and 
requests that you select those to be saved. It then displays a list of the 
files currently on the data diskette. You can choose to store the selected 
series in an existing file or create a new file. If you choose an existing 
file, all the data that is currently in that file is erased and replaced by the 
new series, not just those series with the same name. If you choose to store 
the series in a new file, you are prompted to name the file. If you do not 
specify a name, the SAVE request is cancelled. 
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SCATTER (Plot program—Select menu) 

The SCATTER function specifies that a scatter chart is to be drawn. You 
are asked to select the series to be plotted along the X-axis and the Y-axis. 
The X-axis is scaled to the minimum and maximum for the X-axis series 
and the Y-axis is scaled correspondingly for the Y-axis series. The range 
of a scatter chart is the intersection of the two series and is not explicitly 
shown in the chart. You can change the range. 

A scatter chart can be drawn with points or plotting symbols. If you 
don't make a choice with the ORMAT function, plotting symbols are used. 

When you RESCALE a scatter chart, you are asked for new scale values 
for both the X- and Y-axis. 

The X-axis scale factor, when required, is displayed below the X-axis. 

SELECT (Plot program—Main Plot menu) 

The SELECT function calls the Plot program Select menu from which 
you can select the type of chart to be drawn. The SELECT function does not 
eliminate the current active series until a new chart is selected and it does 
not change the current options in effect. You can keep the currently 
active series by choosing NONE and returning to the Main menu. To elim¬ 
inate the current active series and the current options you have set, use 
the NEW function to call the Select menu. 

The selected series name is displayed in the bottom line of the Main 
Plot status area. If you select multiple series, the name of the last one 
selected is displayed in the status area. When you select multiple series, 
the chart type in the Main Plot status area is followed by an ellipsis (...). 

SET (Plot program—Range menu) 

The SET function sets a new range for the series. You are prompted to 
enter new start and end dates for the new range. The range you set can 
be eliminated with the Range menu CLEAR function. 

SLOT (Storage Management program—Main menu) 

The SLOT function chdnges the currently assigned slot number for the 
data diskette drive. After the program is loaded, the slot from which the 
program was loaded is used as the data diskette slot number. When the 
SLOT function is selected, the slot number is changed to the next lower 
consecutive slot if it contains a disk drive controller. If there is no con¬ 
troller in the next lower slot number, the SLOT function is ignored. 
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If you have disk drive controllers in slots 5 and 6 the SLOT function 
switches between them. If you have controllers in slots 4, 5, and 6, the 
function switches from 6 to 5 to 4 to 6 and so on. If you have controllers 
in slots 4 and 6, the function is ignored. The SLOT function performs no 
function if there is disk drive controller card in a slot immediately adjacent 
to the boot slot. 

The VisiTrend/VisiPlot program is always loaded from the controller 
plugged into the highest slot number. 

SMOOTH (VisiTrend program—Function menu) 

The SMOOTH function performs single exponential smoothing of the 
source series. You are prompted to select a series from those in memory. 
You must also select a weighting factor. The factor must be between 0 and 
1. The smoothed series is saved under the name of the source series with 
".S" appended to the name. 

For each data point i in series Y and a smoothing factor of n, the 
function generates a corresponding point i in series X according to the 
algorithm: 

Y(d= a X(i.,)+ (l-aJY^.,) 


SPECS (Storage Management program—Edit commands 
menu) 

(VisiTrend program—Edit commands menu) 

The SPECS function changes the specifications of the current series. 
The specifications that can be changed are the name of the series, the 
period, and the start date. For further information see . , PER, and 
START. 

START (Storage Management program—Edit Specs menu) 
(VisiTrend program—Edit Specs menu) 

The STAR! function changes the starting date of the current series. 
The series dates are changed immediately and shown in the display. 

STATS (VisiTrend program—Analyze menu) 

The STATS function computes descriptive statistics on one or more 
series. When two or more series are selected, this function also computes 
and displays the correlation coefficients of the selected series. If you do 
not explicitly set a data format, the statistics are displayed in floating point 
format and the correlation coefficients are displayed to three decimal 
places. 
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The function uses the following formulas. 

For a series XI, X2,... Xn 

The mean X = 2Xi 
n 

The population variance a 2 =^s where ss_= 2 (Xi-X) 

n n 

The population standard deviation a = \/ ss 

n 

The STATS display is 40 columns wide. If more data than will fit in 40 col¬ 
umns is selected, some of the data is ignored. 

The program prompts you to select one or more series. After selecting 
the series, you have a chance to keep the existing range or change it. If 
you don't change the range, the function uses the union of the ranges of 
all selected series. If you change the range, you are prompted for major 
and minor (if applicable) start and end dates. You have the option of 
printing the statistics. 

SWITCH (Plot program—Window menu) 

The SWITCH function switches from one window to the other when the 
program is in two-window mode. This function does not affect the chart 
displayed in the current window. The current window designation, which 
is in the lower right corner of the status area, is changed to show the 
window that is being used. 

When you switch windows, the chart in the window you leave is frozen. 
You cannot return to the window and make changes to it; you must 
return to the window and start over with the selection process. 

SYMBOLS (Plot program—Format menu) 

The SYMBOLS function specifies that a chart is to be drawn with plotting 
symbols alone (no interconnecting lines). This function is used in the 
Format menu for line and scatter charts. 

TABLE (VisiTrend program—Analyze menu) 

The TABLE function produces a table of one or more series. You are 
prompted to select the series to be displayed. After selecting the series, 
you are given the option to keep the existing range or change it. If you 
don't change it, the program uses the union of the ranges of all selected 
series. If you choose to change the range, you are prompted for start and 
end dates. 
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The function display is a total of 40 character columns wide. If you select 
more series than will fit, those that will not fit are ignored. Because of the 
column width, longer series names are truncated. 

The table is displayed 20 lines at a time. After each 20 lines, you are 
prompted to continue to the next 20 lines, print the current screen display 
and continue, or exit the function. 

TITLE (Plot program—Options menu) 

The TITLE function calls the Title menu, which contains the functions to 
add top, bottom, left, and moveable titles to the currently displayed chart. 
For more information see TOP, BOTTOMn, LEFT, LEGEND, and MOVEABLE. 

TOP (Plot program—Title menu) 

The TOP function centers a title over the displayed chart. The top title is 
limited to 38 characters. You are prompted to enter the title and then 
asked if it should be displayed in normal or bold typeface. You return to 
the Title menu for the TOP function. 

TOTAL (VisiTrend program—Function menu) 

The TOTAL function generates a new series that contains the cumulative 
total of the data points in the source series. The first data point in the 
TOTAL series is equal to the first point in the source series. The second 
point in the new series is equal to the first plus the second points in the 
source, and so forth. 

TREND (Storage Management program—Main menu) 

The TREND function specifies that the VisiTrend program is to be 
loaded. You must verify that you want to change programs by pressing 
the Y key in response to the message 1YPE Y TO CONFIRM. If you press any 
other key, the request to change programs is cancelled. 

UNDO (Storage Management program—Edit commands 
menu) 

(VisiTrend program—Edit commands menu) 

The UNDO function discards all changes made to a series during an 
editing session. This function restores the series to the condition it was in 
when it was selected for editing. When you UNDO a newly created series, 
it is deleted. 
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UNLABEL (Plot program—Options menu) 

The UNLABEL function erases the X- and/or Y-axis labels. The function 
displays the Unlabel menu which offers the choice of erasing horizontal 
(X-axis) labels, vertical (Y-axis) labels, or both. You can also exit the 
function without erasing either. When the vertical labels are erased, a left 
title is also erased if it is present. If no chart is displayed, this function 
immediately returns to the Main menu. 

VERT (Plot program—Grid, Unlabel, and Window menus) 

The VERT function specifies that the currently selected function is to be 
performed in a vertical manner. 

In the Grid menu, VERT draws vertical grid lines on the current chart. 

In the Unlabel menu, VERT erases the current vertical labels. 

In the Window menu, VERT divides the screen into side by side windows. 

WINDOW (Plot program—Main Plot menu) 

The WINDOW function divides the screen into two windows, switches 
between the windows, and changes back to a single, full screen window 
format. This function divides the screen into a horizontal configuration 
with top and bottom windows or a vertical configuration with side by side 
windows. 

The chart legends are not displayed in the window mode. 

The window mode is displayed in the extreme lower right corner of the 
status area. If the area is blank, the screen is not divided into two windows. 
When the screen is divided, the codes WT, WB, WL, or WR are displayed, 
indicating that the current window is the top, bottom, left or right window. 

The two-window mode is cancelled by selecting NONE from the Window 
menu. It is also cancelled by the NEW function from the Main manu and 
when a PIE chart is selected. 

XFORM (VisiTrend program—Main menu) 

The XFORM function transforms any existing series or groups of series 
through mathematical operations to create a new series. 

You are prompted to enter a name for the series to receive the trans¬ 
formed values. If you press RETURN without entering a series name, the 
program generates a name in the form SERIESn, where n is a digit. 




VISITREND™+ VISIPLOT™ G US U S/ 


APPLE II 

REFERENCE 


After naming the new series, you are prompted to enter the transform 
expression. The list of series in memory is displayed with this prompt. 

To enter the transform, type it at the keyboard. However, do not type 
name of the series. To enter a series name into the transform, press the 
right arrow key. The cursor appears in the series listing. The indicated 
name appears in the transform. Pressing the arrow keys moves the cursor 
up and down the listing in the normal manner. As the cursor moves, the 
currently indicated series name replaces the previous name in the 
transform. To select a series, press RETURN or enter the next character 
in the transform expression. 

When the formula or expression is complete press RETURN to perform 
the transformation and create the new series. If the last item in the trans¬ 
form is a series name, you must press RETURN twice, once to select the 
series and once to fix the transform. 

You can erase what you have entered by pressing ESC. ESC erases 
series names as well as characters entered from the keyboard. A series 
name is erased as a whole, not a character at a time. When ESC is first 
pressed, all series names are bracketed with back slashes (/) so they are 
more easily identified. 

There are several ways you can make an error in creating a transform. 
You can enter an invalid expression, such as one with unbalanced paren¬ 
theses, or you can specify an invalid operation such as division with zero. 
When an error is encountered, TRANSFORM ERR is displayed followed by 
a message or number. When a message is displayed, pressing RETURN 
displays more information in some conditions. The number is an Apple¬ 
soft Basic error message number. See the Applesoft Basic Programming 
Reference Manual for a full description of the error condition. 

If you get the message BAD EXPRESSION, you either mismatched paren¬ 
theses (or similar syntactical mistake) or typed a series name instead of 
using the arrow keys to select it. 

In creating transforms you can use the following mathematical 
operators: 

Arithmetic operators: 

4* — Addition 
— — Subtraction 
* — Multiplication 
/ — Division 
A — Exponentiation 
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Logical operators: 

AND 

OR 

NOT 


Comparative operators: 


< — 
<= — 

> — 
> — 
>= — 


Functions: 


SGN — 
INT — 
SQR — 
LOG- 
EXP — 
RND — 
ABS — 


Less than 

Less than or equal 

Equal 

Greater than 
Greater than 
Greater than or equal 


Sign 

Integer part of 
Square root 
Natural logarithm 
e to the power of 

Random number between 0 and 1 
Absolute value of 


Trig functions: 

SIN — Sine 
COS — Cosine 
TAN — Tangent 
ATN — Arctangent 

The functions are applied exactly as in Applesoft Basic. In place of the 
Basic variables, you substitute the name of a VisiTrend/VisiPlot series. 
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ERROR MESSAGES 

The following are the error messages issued by the VisiTrend/VisiPlot 
program. The messages are in alphabetical order by the first word of the 
message. The error descriptions include suggestions on further action 
whenever possible. If an error message with a number appears, see The 
DOS Manual, Apple product number #A2L0036. 

(beep) 

A beep is sounded whenever inappropriate data is entered or an illegal 
operation is attempted. When inappropriate data is entered, no message 
is displayed, only the beep is sounded. When you encounter this, try 
your entry again. You probably pressed the wrong key by mistake, such 
as pressing a letter key when the program was looking for numeric data. 

CANT! BAD PERIODICITIES 

You selected series that have different periods. All series used in a 
chart, whether a multiple series chart or an overlay of two or more charts, 
must have the same period. 

Several conditions can cause this message to be issued: 

• There is no data in the range you specified with the RANGE function. 

• There are more than 150 points in the range. For example, you tried to 
plot two series and the combined ranges of the two series exceeds 150 
points. 

• You attempted to draw a scatter chart with two series that have no 
common values at any date. 

• You attempted to draw a pie chart with one or more series that have no 
data at the date specified for the pie chart. 

CANT! DIVISION BY ZERO 

You specified a division by zero in an XFORM operation. Reenter the 
formula after correcting the division by zero error. 

CANT! ERROR: DISK I/O or DISK ERROR 

This error can be caused by disk problems such as having the drive 
door open, no diskette in the drive, and a full diskette. 

CANT! ERROR: WRITE PROTECTED 

You attempted to save some series in a file on a write-protected diskette. 
Either replace the data diskette with one that is nor write-protected or 
remove the write disable tab from the diskette. You should determine why 
the diskette was write-protected before removing the write disable tab. 
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CANT! NO OPTION HERE 

Certain options are not applicable in all instances. When you see this 
error message, you tried to apply a function that is not legal in the current 
circumstances. Usually, an option can be applied wherever it is meaning¬ 
ful and useful. Some of the invalid uses of options are: 

• Specifying GRID when no chart is displayed on the screen. 

• Specifying the -ORMAT option after selecting the COLOR or BACKGR 
options. (Plotting symbols do not appear properly in color or against 
colored backgrounds.) 

• Specifying BACKGR or COLOR for a pie, scatter, or hi-lo chart. Pressing 
any key except RESET returns to the main menu. 

CANT! NO OVERLAY HERE 

You attempted to use the OVERLAY function when there was no chart 
displayed. Or you specified COLOR or BACKGR and then immediately 
tried to overlay. You can select COLOR or BACKGR, then PLOT, and then 
OVERLAY another series. 


CANT! PLEASE SELECT FIRST 


You attempted to select the OPTIONS functions without first selecting 
a series. Select a series and then return to the OPTIONS function. 


CANT! PRESS ANY KEY 

You are drawing a bar chart that has an off-scale data point. This 
message occurs when the first off-scale bar is encountered. The Visi- 
Trend/VisiPlot program does not draw bar charts with off-scale data. This 
error also occurs if you press CTRL-C or RESET while drawing a graph. 

CANT TRANSFORM! BAD EXPRESSION 

You entered an XFORM expression that contains an illegal operator, 
unbalanced parentheses, or you typed a series name instead of selecting 
it with the cursor and RETURN. 


DATA OFF SCALE: Y TO DISPLAY 

You rescaled the chart and in the new scale, some data points fall 
outside the specified scale. Pressing Y causes a partial plot to be drawn. 
Each time an off-scale value is encountered, the beep sounds. Pressing 
any other key aborts the drawing of the chart. If the chart is a bar chart, 
the plot is aborted when the first off-scale data point is encountered. 
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DISKETTE ALREADY INITIALIZED 

You selected the INI 1 function and the diskette in the data diskette drive 
is initialized. If you continue, the data on the diskette will be erased. Press 
the ESC key to cancel, any other key continues the function. 

NO ACTIVE SERIES 

You attempted to invoke a function that cannot be invoked until a series 
is selected through the Select menu. You may have switched windows 
and forgotten to select a series for the new window. You must select a 
series after switching windows, even if you want to plot the same series. 

NO MORE ROOM! 

You tried to LOAD a file when there was not enough room in memory 
to hold all the series in the file. You must CLEAR enough series out of 
memory to make room for the series in the file. 

It is possible to get this error message if a non-VisiTrend/VisiPlot file, 
that because of its format is mistaken for a VisiTrend/VisiPlot file, is 
loaded. 

PUT IN PROGRAM DISKETTE, PRESS ANY KEY 

You tried to change programs when the VisiTrend/VisiPlot program 
diskette was not in the boot slot. Insert the VisiTrend/VisiPlot program 
diskette and press any key except RESET to continue. 

PLEASE SELECT FIRST 

You selected the TO I or OPTIONS function when there was no current 
series to be plotted. You may have switched windows; you must use the 
E. 11 CI function to select a series after switching windows, even if you 
want to plot the same series. 

UNABLE TO LOAD: WRONG FORMAT 

You attempted to load a data file that is not in the VisiTrend/VisiPlot 
data format or the LA format. Only files in these formats can be loaded by 
the VisiTrend/VisiPlot program. 

WON'T! THIS IS THE PROGRAM DISKETTE 

You selected the INI I function and the drive that the program found in 
the data diskette drive is the VisiTrend/VisiPlot program diskette. Initializ¬ 
ing a diskette destroys everything on it. You cannot continue because 
you would destroy your program diskette. 
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SAMPLE PRINT PIXSAVE PROGRAM 

The following program prints a chart that was saved on diskette in 
binary format with the PIXSAVE function in the Plot program. This program 
assumes: 

• The VisiTrend/VisiPlot program diskette is in Drive 1 and contains the 
printer drive program under the name VISIPLOT.DRIVER. 

• The data diskette is in Drive 2 and contains the PIXSAVE file that is to be 
printed. The sample program uses the name PLOT.PIX; change this 
to the name of your file. 

• The printer interface card is plugged into Slot 1. The slot number is 
defined in the SLOT = 1 statement. If your printer is plugged into 
slot 5, you would enter the statement as SLOT = 5. 

To create a program and save it on the program or any other diskette, 
enter the following: 

NEW 

1 REM DEFERRED MODE EXAMPLE 
10 D$ = CHR$ (4) 

20 SLOT = 1 

30 PRINT D$;"BLOAD VISIPLOT.DRIVER,Dl / A$98C3 ,, 

40 HGR 

50 PRINT D$;"BLOAD PLOT.PIX,D2,A$2000" 

60 POKE 39118,SLOT 
70 PRINT D$;"PR#";SLOT 
80 CALL 39125 
90 TEXT 

100 PRINT D$;"PR#0" 

110 END 
SAVE <name> 

See The DOS Manual for details on saving a program on diskette and 
the Applesoft Basic Reference manual for details on entering a program 
in deferred mode. 
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You can also enter a series of commands in immediate mode and have 
them executed as you enter them. This series of commands must be 
entered each time you want to print a chart. 

D$ = CHR$(4) 

SLOT = 1 

BLOAD VISIPLOT.DRIVER,D1,A$98C3 

HGR 

BLOAD PLOT.PIX,D2,A$2000 
POKE 39118,SLOT 
PRINT D$,"PR#";SLOT 
CALL 39125 
PRINT D$;"PR#0" 

TEXT 

NOTE: When you enter statements in immediate mode, the statements 
may not appear on the screen after typing HGR. This is a normal condi¬ 
tion, not an error. TEXT restores the screen to normal (non-graphics) 
mode. 

See the Applesoft Basic Programming Reference manual for details 
about entering commands in immediate mode. 
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SUPPORTED GRAPHIC PRINTERS 

The VisiTrend/VisiPlot program supports the following graphic 
printers: 

• Apple Silentype 

• IDS Paper Tiger 440 and 445 (with graphics option installed) 

• NEC Spinwriter 5510, 5515, 5520, and 5525 (with NEC-graphics option 
installed) 

• Trendcom 200 

Any printer and model not specifically mentioned is not supported. 

The VisiTrend/VisiPlot program operates correctly in serial mode with 
the Apple Serial Interface card or the Apple Communications Interface 
card. Operation with any other serial or communications interface card 
may produce incorrect results. 

In support of these printers, the VisiTrend/VisiPlot program diskette 
contains several driver programs. The printer drivers are for the combina- 
'w tions of different printers and the Apple Serial, Communications, and 
Parallel Interface cards. The serial drivers operate with the Apple Serial 
Interface card and the Apple Communications Interface card. 

The program uses only one printer driver that must be named 
VISIPLOT.DRIVER. To use a different printer you must RENAME one of 
the supplied drivers on the program diskette to VISIPLOT.DRIVER. 

The program comes with the driver for the Apple Silentype stored as 
VISIPLOT.DRIVER. If you use a different printer, first rename VISI¬ 
PLOT.DRIVER to SILENTYPE.D and then rename the driver for your 
printer to VISIPLOT.DRIVER. It is advisable to write down the name of 
the driver that you rename VISIPLOT.DRIVER. Use the same names if 
you change drivers, this could save you considerable trouble if you 
change printers often. To change the names you must use the DOS 3.3 
RENAME command. Be sure to remove the write disable tab before 
attempting to RENAME a driver file. Also be sure to replace the write 
disable tab after changing the names. 

When using the printer drivers, it is your responsiblity to position the 
paper in the printer before you request the printing of listings or charts. 
No automatic form feeds, top of form, and so forth are provided. 

^ Table B-l lists the driver names for the various configurations of the 

supported printers. The references to double width graphics and auto 
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linefeeds are software functions, not hardware options. You need no extra 
equipment to use them. Auto linefeed means that the printer driver 
automatically supplies a linefeed after each carriage return. If your print¬ 
ing comes out double spaced and you are using an auto linefeed driver, 
use the corresponding non-auto linefeed driver. If your printing comes 
out all on the same line and you are not using an auto linefeed driver, 
use the corresponding auto linefeed driver. 


TABLE B-l. Drivers for the Supported Printers 


PRINTER 

DRIVER NAME 

DESCRIPTION 

Apple 

Silentype 

SILENTYPE.D 

Apple Silentype Printer/ 

Interface 


SILENTYPE-DW.D 

Apple Silentype w/double 
width graphics 

IDS Paper 
Tiger 

IDS-44X-S.D 

IDS 440G/445G w/Apple Serial 
Interface or Apple Communi¬ 
cations Interface 


IDS-44X-S-LF.D 

IDS 440F/445G w/Apple Serial 
Interface or Apple Communi¬ 
cations Interface w/auto 
linefeed 


IDS-44X-P.D 

IDS 440G/445G w/Apple 

Parallel Interface 


IDS-44X-P-LF.D 

IDS 440G/445G w/Apple 

Parallel Interface w/auto 
linefeed 

NEC 

Spin writer 

NEC-SPINW-S.D 

NEC Spinwriter w/Apple 

Serial Interface or Apple 
Communications Interface 


NEC-SPINW-S.LF.D 

NEC Spinwriter w/Apple 

Serial Interface or Apple 
Communications Interface 
w/auto linefeed 


NEC-SPINW-P.D 

NEC Spinwriter w/Apple 

Parallel Interface 


NEC-SPINW-P-LF.D 

NEC Spinwriter w/Apple 

Parallel Interface 
w/auto linefeed 

Trendcom 

TRENDCOM.D 

Trendcom 200 printer/ 
interface 


TRENDCOM-DW.D 

Trendcom 200 w/double 
width graphics 
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PRINTER SUPPORT FOR NON-GRAPHIC PRINTERS 

If you have a printer other than the supported graphic printers, you 
can print listings but not charts. Textual printing is supported for specific 
interfaces as opposed to specific interface/printer pairs. There are four 
printer drivers for the Apple parallel interface and serial or communica¬ 
tions interfaces with and without automatic linefeed. The drivers are listed 
in Table B-2. 


TABLE B-2. Drivers for the Text-only Interfaces 


INTERFACE 

DRIVER NAME 

DESCRIPTION 

Parallel 

TEXT-PD 

Apple Parallel, w/o auto linefeed 

TEXT-P-LF.D 

Apple Parallel, w/auto linefeed 

Serial 

TEXT-S.D 

Apple Serial or Communications, 
w/o auto linefeed 

TEXT-S-LF.D 

Apple Serial or Communications, 
w/auto linefeed 



IDS PAPER TIGER 440/445 

You must have the graphics option to print VisiTrend/VisiPlot charts. 
The graphics option is denoted by a G in the model number i.e. 440G and 
445G. Without the graphic option, you can print only listings not charts. 

Serial Operation 

For operation with the Apple Serial Interface card, the P8 PROM, not 
the P8A PROM, must be installed in the interface card. 

The Baud rate limit is 1200. 

For operation with the Apple Communications Interface card, the Baud 
rate is 300 for an unmodified card. During printing, the data may also 
appear on the screen. When printing is completed, the screen image 
returns to normal. 
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The DIP switch settings lor use with the VisiTrend/VisiPlot program 
and a serial interface card shown in Table B-3. 


Table B-3. Paper Tiger Switch Settings with Serial Interface Card 


DIP 

SWITCH 

OPTION 

SWITCH SETTING 

DIPS4 

SW1,2 

Character Density 

User Choice 

SW3 

Lines Per Inch 

User Choice 

SW4 

Auto Page Skip 

User Choice 

SW5 

Auto Linefeed 

User Choice (Select 
driver to match settings) 

SW6 

Remote Printer 
Control Deselect 

OFF 

SW7 

Power Source 

OFF (60 Hz) 

DIPS5 

SW1,2,3 

Page Size 

User Choice 

SW4,5 

Baud Rate 

User Choice (Must 
match serial card baud 
rate selection.) 

SW6 

Graphics Print 
Capability Enable 

ON (Switch is meaning¬ 
less for printers without 
graphics option.) 

SW7 

Serial EIA 
Interface Selection 

ON 


You must use a cable that directly connects pins 2, 3, and 7 directly 
between the male and female ends. The lines connecting pins 2 and 3 
must not be swapped. 

The switches on the Apple Serial Interface card should be set as 
shown in Table B-4. 


Parallel Operation 

To use the Apple Parallel Interface card use the printer DIP switch 
settings shown in Table B-5. 
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NEC SPINWRITER 5510, 5515, 5520, and 5525 

The NEC Spinwriters require the NEC-compatible graphics option. 
They will not operate correctly with the VisiTrend/VisiPlot program if the 
Diablo-compatible graphics option is installed. 


Table B-4. Apple Serial Interface Card Switch Settings for 
Paper Tiger Printers 


SWITCH 

OPTION 

SWITCH SETTING 

1,2,3 

Baud Rate 

User Choice; 1200 Baud Maximum 

4 

Carriage 
Return Delay 

OFF 

5,6 

Paper Size 

User Choice (Must NOT be set 
to ON/ON.) 

7 

Auto Linefeed 
Disabled 

ON (Disabled is preferred—the setting 
is overridden by the printer driver.) 


If your Apple Serial Interface card has the P8 PROM, the serial opera- 
tion speed cannot exceed 300 baud. If the P8A PROM is installed, the 
speed cannot exceed 1200 baud. 

For operation with the Apple Communications Interface card, the Baud 
rate is 300 for an unmodified card. During printing, the data may also 
appear on the screen. When printing is completed, the screen image 
returns to normal. 

The Spinwriter may beep and not start printing when you first attempt 
to print after the Apple II is powered-on. To clear this, press the RETURN 
key on the Apple keyboard. 


The switches on your Spinwriter should be set as shown in table B-6. 
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Table B-5. Paper Tiger Switch Settings With A Parallel 
Interface Card 


DIP 

SWITCH 

OPTION 

SWITCH SETTING 

DIPS4 

SW1,2 

Character Density 

User Choice 

SW3 

Lines Per Inch 

User Choice 

SW4 

Auto Page Skip 

User Choice 

SW5 

Auto Linefeed 

User Choice (Select correct 
driver to match setting.) 

SW6 

Remote Printer 
Control Deselect 

OFF 

SW7 

Power Source 

OFF (60 Hz.) 

DIPS5 

SW1,2,3 

Page Size 

User Choice 

SW4,5 

— 

Not Used 

SW6 

Graphics Print 
Capability Enable 

ON(Switch is meaning¬ 
less for printers without 
graphics option.) 

SW7 

Parallel TTL 
Interface Selection 

OFF 


APPLE SILENTYPE 

No set-up is required. Use the printer driver that matches your 
configuration. 

TRENDCOM 200 

No set-up is required. Use the printer driver that matches your 
configuration. 
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Table B-6. NEC Spinwriter Switch Settings 


SWITCH 

SETTING 

Speed 

User Choice (Same as speed set on interface card.) 

Parity 

User Choice (Same as parity set on 
interface card.) 

Duplex 

Not Applicable 

Local LF 

OFF 

LF 

6 

SP 

10 

Form Length 

User Choice (Set as appropriate for paper in use.) 

Remote/Local 

Remote (If switch is present.) 
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THE VISITREND™/VISIPLOT™ INTERNAL DATA 
FORMAT 

VisiTrend/VisiPlot data series can be stored in either of two formats: 
the VisiTrend/VisiPlot data format and the DIF format. Data is stored in 
the VisiTrend/VisiPlot data format when you select NORMAL from the 
SAVE format menu. It is stored in the DIF format when you select DIF. Data 
in the DIF format can be used by other Personal Software programs. 

The VisiTrend/VisiPlot data format is described in this appendix. The 
DIF format is described in the document Programmer's Guide to the 
Data Interchange Format, number SATN-18 which is available from 
the DIF Clearinghouse, P.O. Box 527, Cambridge, MA 02139. 

A VisiTrend/VisiPlot data file is an Apple Sequential Text File which is 
described in The DOS Manual, Apple number A2L0036. The fields are 
variable length and each field is terminated with a RETURN. The follow¬ 
ing list contains a description of the contents and, in parentheses, the 
limitations on and expected contents of the fields. 

The fields of a data file are: 

Number of series (1-16) 

Series name (string—up to 14 characters) 

Number of data points (1-150) 

Periodicity (1-99) 

Start year (0-2499) 

Start period.(1 -periodicity) 

End year (must be consistent with the start year and 

End period period, the periodicity, and number of points) 

Data point 1 
Data point 2 
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Data point n 


The following is the listing of a sample file containing two series, named 
FIRST and SECOND. FIRST has a period of 1 and contains five data 
points beginning at date 1. The values of the data points are 100, 200, 300, 
400, and 500. Second has a period 1 and contains 3 data points beginning 
at date 1980. The values of the data points are 1111, 2222, and 3333. 


2 

FIRST 

5 

1 

1 

5 

1 

100 

200 

300 

400 

500 

SECOND' 

3 

1 

1980 

1 

1982 

1 

1111 

2222 

3333 


Number of series in file 
Series flame \ 

Periodicity 
Start date 
Start period 
End date 

End period V first series 
Data points 


Second series 
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—> TREND 2-47, 2-67, 3-32 
1 through 9 2-16 
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c 

Calculating series statistics 2-73 
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Changing 
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PIE 1-3, 1-8, 2-99, 3-25 
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EDIT 2-58, 3-15 
EXIT 2-57, 3-15 
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Confusing the VisiPlot program 
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CONTINUE 2-37, 3-14 
Control-C 1-17 
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Converting an N +1 moving 
average 2-85 
Copyright notice 1-20 
Creating a data diskette 2-45 
Creating series data 2-53, 3-15 
CTRL key 1-22 
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Cursor 1-7, 1-9, 1-21 

D 

Data 

diskette address 2-34, 3-15 
diskettes 2-34 

drive number, changing 2-40, 
3-15 

entry 2-55 

formatting 2-61, 3-16 
interchange format 1-7, 2-49, 
3-14 

internal formats C-l 
keeping between programs 
2-48 

loading 2-35, 3-20 
point 1-10 

points, deleting 2-59, 3-14 
points, inserting 2-59, 3-18 
saving 2-42, 3-28 
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Date 1-10 
DEFAULT 3-14 
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files 2-48, 3-14 
series 2-46, 3-12 
DIF 2-42, 2-49, 3-14 
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drives 2-40, 3-15 
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care 1-14 
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program 1-13, 2-34 
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Displaying 
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DRIVE 2-40, 3-15 
Drive 1 2-40 
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Drive 

address 2-40, 3-15 
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EXIT 2-57, 3-15 
FILL 2-62, 3-15 
FORMAT 2-61, 3-16 
INSERT 2-59, 3-18 
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Erasing 

data points 2-59, 3-14 
moveable titles 2-18, 3-21 
series 2-27, 3-12 
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File name qualifiers 2-75, 2-79, 
3-4 

Files 

and series 2-39 
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Frequency 1-11 
Function 1-11 
FUNCTION 
description 2-79 
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GRID 1-11,2-29, 3-17 
Grid lines 2-29, 3-17 
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Keyboard 1-16, 3-1 
Keyboard usage 3-1 
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Listing a series 2-61, 3-26 
LOAD 2-35, 3-20 
Loading 

VisiCalc data 2-49 
VisiPlot data 2-35, 3-20 
the program 1-18, 2-2 
the VisiTrend program 2-67 
Logical operators 2-86, 3-35 
Long prompt 1-21, 3-3 
LOOKUP 2-38, 3-21 
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MAIN 2-49 
Main plot menu 2-5 
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menu 2-49 
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3- 21 

Menu 1-11 
Menus 

Analyze 2-70 
Bar 2-8 

Edit Commands 2-57 
Fill 2-62 
Function 2-79 
Grid 2-29 
Main Plot 2-5 

Main Storage Management 
2-33 

Options 2-11 
Select 2-4 
Specs 2-60 
Title 2-12 
Typeface 2-13 
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DEFAULT 3-14 
DELETE 2-48, 3-14 
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EDIT 2-53, 3-15 
EXIT 2-57, 3-15 
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FUNCTION 2-69 
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HI-LO 3-17 

HORIZ 2-29, 2-102, 3-17 
INIT 2-45 
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JUMP 2-59, 3-18 
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LOAD 2-35, 3-20 
LOOKUP 2-38, 3-21 
—>MAIN 2-31, 3-21 
MAIN 2-49 
MOV AVG 2-80, 3-23 
MOVEABLE 2-15, 3-21 
NAME 2-61,3-23 
NEW 2-25, 3-23 
NONE 2-4, 3-23 
NORMAL 2-42, 3-24 
OPTIONS 2-11,3-24 
OVERLAY 2-97, 3-24 
PER 3-25 
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PIE 2-99, 3-25 
PIXSAVE 2-31,3-26 
—>PLOT2-3, 2-47, 3-26 
PLOT 2-6, 3-26 
PRINT 2-30, 3-26 
QUIT 2-49, 3-26 
RANGE 2-24, 3-27 
SPECS 2-60, 3-30 
START 2-61,3-30 
STATS 2-73, 3-30 
SWITCH 2-101,3-31 
SYMBOLS 2-26, 3-32 
TABLE 2-71,3-31 
TITLE 2-12, 3-32 
TOP 2-13, 3-32 
TOTAL 2-83, 3-32 
—> TREND 2-47,2-67, 3-32 
UNDO 2-62, 3-32 
UNLABEL 2-31,3-33 
VERT 2-29, 3-33 
WINDOW 2-101,3-33 
XFORM 2-86, 3-33 
Messages, error 3-36 
Modifying data series 2-56, 3-15 
Modulator, RF 1-13 
Monitor 1-12 
MOVE AVE 2-80, 3-23 
MOVEABLE 2-15, 3-21 
Moveable title speed 2-16, 3-21 
Moveable titles 2-15, 3-21 
Moving average 
converting 2-85 
description 2-80 
Moving 

a title 2-15, 3-21 
from point to point, jump 2-59, 
3-18 

Multiple regression 1-10 

N 

Name 2-4 
NAME 2-61,3-23 
Naming conventions 2-75, 2-79, 
3-4 


NEC Spin writer 1-6 
storage format 2-42 
typeface 2-13, 3-24 

o 

Operators 2-86, 3-35 
OPTIONS 2-11,3-24 
Option menu 2-11 
Options, plotting 2-11, 3-24 
OVERLAY 2-97, 3-24 

P 

Paper Tiger 1-6 
PER 2-4, 3-25 
Percent of change 2-82 
Performing a linear multiple 
regression 2-74 
Period 1-11, 3-25 
Pie chart 1-3, 1-8, 2-99, 3-25 
PIE chart data 2-98 
PIXSAVE 2-31,3-26 
PLOT 2-6, 3-26 
Plot program 2-2 
Point, data 1-11 
Pound sign (#) 2-5 
Power switch 1-19 
PRINT 2-30, 3-26 
Print PIXSAVE Program A-l 
Printer support 1-17 
Printers 

Apple Silentype 1-6 
IDS Paper Tiger 1-6 
NEC Spinwriter 1-6 
Trendcom 1-6 
Printing 

charts 2-30, 3-26 
data from the screen 2-61, 3-26 
Program diskette 1-13, 2-34 
Program loading 1-18, 2-2 
Progressions 
ARITH 2-63, 3-10 
GEOMET 2-63, 3-17 
Prompt, long 1-21, 3-3 
Putting titles on a chart 2-12,3-32 
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QUIT 2-49, 3-26 

R 

RAM memory 1-12 
Rangel-11,2-19, 3-3, 3-27 
RANGE 2-24, 3-27 
Range, changing 2-23, 3-3, 3-27 
Recovering the legend 2-18, 3-12 
Recovery from a Monitor 
transfer 3-2 
Reference 3-1 
REGRESS 2-74, 3-27 
Regression, multiple 1-10 
Removing 
changes 2-62, 3-32 
data points 2-59, 3-14 
diskettes 1-15 
series 2-46, 3-12 
Replacing values in a series 

2- 56 

Requirements, computer 1-12 
RESCALE 2-20, 3-28 
RESET key 1-16, 1-22 
RETURN 1-16 
Returning 

to the Basic program 2-49, 

3- 26 

to the edit function 2-58, 3-15 
to the main menu 2-49, 3-15 
Reverse video 1-20 
RF modulator 1-13 
RIGHT 2-8, 3-28 
Series 

adding values 2-55, 3-18 
and files 2-39 
calculating statistics 2-73 
clearing from memory 2-46, 
3-12 

data 1-12 

naming conventions 2-75, 

2- 79, 3-4 

specifications, changing 2-61, 

3- 30 


SET 2-24, 3-29 

Setting up the computer 1-12 
Shading and titling a pie chart 
2-100 
Shift 1-22 
SLOT 2-41,3-29 
Slot 

address 2-41, 3-29 
and drive address 2-40, 3-15 
SMOOTH 2-81,3-30 
Smoothing, exponential 1-11 
Space bar 1-16, 3-1 
SPECS 2-60, 3-30 

s 

SAVE 2-42, 3-28 
Saving 2-42, 3-28 
Scale 1-11, 2-19, 3-6, 3-28 
Scale, changing 2-20, 3-6, 3-28 
SCATTER 1-4, 1-8, 2-104, 3-29 
Scrolling the screen 2-64 
SELECT 2-8, 3-29 
Select menu 2-4 
Selecting a menu item 1-21 
Speed of moveable titles 2-16, 
3-21 
Start 2-4 

START 2-61,3-30 
Starting date 2-4 
Startup display 1-20 
Statistics, calculating 2-73 
STATS 2-73, 3-30 
Status area 1-20, 3-3 
Storage Management functions 
2-33 

Storage management 2-32 
Summary 1-23 

Supported Graphic Printers B-l 
SWITCH 2-101,3-31 
Switch, power 1-19 
SYMBOLS 2-26, 3-32 
System Master Diskette 1-18, 
1-19 
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TABLE 2-71,3-31 
Table format listing 2-71 
Three line display 2-93 
TITLE 2-12, 3-32 
Title 

menu 2-12 
moveable 2-15 
Titling 

a chart 2-12, 3-32 
and shading pie chart 2-100 
TOP 2-13, 3-32 
TOTAL 2-83, 3-32 
Totaling a series 2-83 
—> TREND 2-47, 2-67, 3-32 
Trendcom 1-6 
Trend forecasting 2-77 
TV set 1-12 
Two line display 2-92 
Typeface 
BOLD 2-13, 3-12 
NORMAL 2-13, 3-24 

u 

UNDO 2-62, 3-32 
UNLABEL 2-31,3-33 
Using 

FUNCTION 2-79 

the ANALYZE function 2-70 

the Edit function 2-53 

the program 1-7 

the VisiTrend program 2-67 


Y 

VERT 2-29, 3-33 
Vertical 
axis 1-12 

grid lines 2-29, 3-17 
Video 

monitor 1-12 
reverse 1-20 
VisiCalc 2-49 

w 

WINDOW 2-101,3-33 
Wraparound, cursor 1-21 
Writing a series transformation 
2-86 

X 

X-axis 1-11 
XFORM 2-86, 3-33 

Y 

Y key 2-3 
Y-axis 1-11 
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